Home

Tecplot 360 Data Format Guide

1. Keyword Syntax Required Default Notes Y N TOTALNUMB lt integer gt Y For face based finite element zones only OUNDARYCO Total number of entries for boundary items listed in the Facemap Data section NNECTIONS Set to zero if boundary faces aren t used FACENEIGH N LOCALO For ordered or cell based finite element BORMODE LOCALONE NETOON zones only Used to indicate whether the TOONE E neighboring faces are within the current zone or in another zone i e local or LOCALONET global as well as whether the OMANY connections are one to one or one to many When this token is used both the GLOBALON FACENEIGHBORCONNECTIONS ETOONE token and the FaceNeighbor Connections List are required Refer to Section Face GLOBALON Neighbor Connections List on page 161 ETOMANY for details FACENEIGH lt integer gt Y if For ordered or cell based finite element BORCONNEC FACENEIGHBO zones only Used to indicate the total TIONS RMODE is in use number of connections for all elements in the zone For example if you have two cells with three connections each the number of face neighbor connections is equal to six When this token is used both the FACENEIGHBORMODE token and the FaceNeighbor Connections List are required Refer to Section Face Neighbor Connections List on page 161 for details DT N SINGLE Each variable in each zone in the data lt datatype gt file may have its own data type The da
2. Node x Y P A 0 0 1 0 100 0 1 6 B 1 0 1 0 150 0 1 5 C 3 0 1 0 300 0 2 0 D 0 0 0 0 50 0 1 0 E 1 0 0 0 100 0 1 4 F 3 0 0 0 200 0 2 2 G 4 0 0 0 400 0 3 0 H 2 0 2 0 280 0 1 9 You can create a POINT Tecplot 360 data file for this data set as follows a 2D mesh plot of this data set is shown in Figure 4 11 TITLE Example VARIABLES X ONRFNBWRFOWF O NIWNDOOOOOOOOoO WAUNOOOORPP WUIRO0OO0OO0OO0OOOO 100 0 1 6 150 0 1 5 300 0 2 0 y ZONE NODES 8 ELEMENTS 4 m DATAPACKING POINT 2D Finite Element Data pr ZONETYPE FEQUADRILATERAL 1 Background information for FE data sets is provided in Section 3 2 2 Indexing Cell centered Ordered Data in the User s Manual 187 ASCII Data 3288 DE CC LAN 1 1 2 3 4 x Figure 4 11 A mesh plot of 2D finite element data The ZONE record describes completely the form and format of the data set there are eight nodes indicated by the parameter NODES 8 four elements indicated by the parameter ELEMENTS 4 and the elements are all quadrilaterals as indicated by the parameter ZONETYPE FEQUADRILATERAL The same data file can be written more compactly in BLOCK format as follows TITLE Example 2D Finite Element Data VARIABLES X Y P T ZONE NODES 8 ELEMENTS 4 DATAPACKING BLOCK ZONETYPE FEQUADRILATERAL 0
3. FLOAT32 INT32 N INT32 INT32 FLOAT64 INT32 INT32 INT32 This is used to determine the byte order of the reader relative to the writer names FileType 0 FULL 1 GRID 2 SOLUTION The TITLE See note 1 Number of variables NumVar in the datafile Variable names N L 1 L 2 L NumVar where L i length of the ith variable name 1 for the terminating 0 value See note 1 Zone marker Value 299 0 Zone name See note 1 N length of zone name 1 ParentZone Zero based zone number within this datafile to which this zone is a child StrandID 2 pending strand ID for assignment by Tecplot 1 static strand ID 0 lt N lt 32700 valid strand ID Solution time Not used Set to 1 ZoneType 0 ORDERED 1 FELINESEG 2 FETRIANGLE 3 FEQUADRILATERAL 4 FETETRAHEDRON 5 FEBRICK 6 FEPOLYGON 7 FEPOLYHEDRON Specify Var Location 0 Don t specify all data is located at the nodes 1 Specify 210 if specify var location INT32 NV INT32 INT32 Variable Location only s
4. 151 ASCII Data File Header Components Token Syntax Notes TITLE lt string gt The title will be displayed in the headers of Tecplot 360 frames FILETYPE FULL GRID or Specifies the data file type A full data file contains both grid and SOLUTION solution data If omitted the FILETYPE will be treated as FULL VARIABLES VARNAME1 You may also assign a name to each of the variables by including a line VARNAME2 that begins with VARIABLES followed by each variable s name VARNAMES enclosed in double quotes Tecplot 360 calculates the number of VARNAMEN variables N from the list of variable names If you do not specify the variable names and your first zone has POINT data packing Tecplot 360 sets the number of variables equal to the number of numeric values in the first line of zone data for the first zone and names the variables V1 V2 V3 and so forth Initially Tecplot 360 uses the first two variables in data files as the X and Y coordinates and the third variable for the Z coordinate of 3D plots However you may order the variables in the data file any way you want since you can interactively reassign the variables to the X Y and or Z axes via the Select Variables dialog accessed via Plot gt Assign XYZ Example Grid File The following example displays a very simple 2D grid file Grid files look like standard Tecplot data files wit
5. Pointer to integer value specifying the line pattern 0 Solid 3 Dotted eee 1 Dashed 4 LongDash 2 DashDot 5 DashDotDot Pointer to double value specifying the pattern length in frame units from 0 01 u and less than 100 Pointer to double value specifying the line thickness in frame units The value ES must be greater than 0 0001 and less than 100 Pointer to integer value specifying the number of points to use for circles and NumEllipsePts ellipses The value must be between 2 and 720 Pointer to integer value specifying the arrowhead style ArrowheadStyle 0 Plain 2 Hollow 1 Filled Pointer to integer value specifying where to attach arrowheads ArrowheadAttachment 0 None 2 End 1 Beginning 3 Both Pointer to double value specifying the arrowhead size in frame units from 0 ArrowheadSize to 100 ArrowheadAngle Pointer to double value specifying the arrowhead angle in degrees Pointer to integer value specifying the scope with respect to frames A local scope places the object in the current frame A global scope places the object in all frames that contain the current frame s data set 0 Global l Local Scope Specifies whether to clip the geometry that is only plot the geometry within Clipping to the viewport or the frame 0 ClipToViewport 1 ClipToFrame NumSegments Pointer to integer value specifying the number of polyline segments Array of integer values specifying
6. nal zones If you intend to create data files that will load in both Tecplot 360 and Tecplot Focus you need to be aware that polyhedral polygonal zones are not supported in Tecplot Focus Ifany of the zones in a given data file are polyhedral you will not be able to load the data file into Tecplot Focus To create data files that will load in both products you must use either ordered zones or cell based finite element zones triangular quadrilateral tetrahedral or brick elements 1 2 Best Practices Users who wish to generate native Tecplot 360 data files automatically from applications such as complex flow solvers have a number of options for outputting data into Tecplot s data format This section outlines a few best practices for outputting your data into Tecplot 360 data format 1 Create Binary Data Files instead of ASCII All else being equal binary data files are more efficient than ASCII files in terms of disk space and time to first image To create binary data files you may use functions provided in the TecIo library included with your Tecplot distribution To create ASCII files you can write out plain text using standard write statements There are some cases where ASCII files are preferred Create ASCII files when e Your data files are small e Your application runs on a platform for which the Tec1o library is not provided Even if this is the case please contact us at support tecplot com There may be a way
7. LINE specify the coordinate positions for the data points in each line segment with XOrThetaGeomData and YOrRGeomData 41 TECINI112 LINE3D specify the coordinate positions for the data points in each line segment with XOrThetaGeomData YOrRGeomData and ZGeomData TECINI12 Initializes the process of writing a binary data file This must be called first before any other TecIo calls are made except TECFOREIGN112 You may write to multiple files by calling TECINI112 more than once Each time TECINI112 is called a new file is opened Use TECFIL112 to switch between files For each call to TECINI there must be a corresponding call to TECEND112 Return Value 0 if successful FORTRAN Syntax INTEGER 4 FUNCTION TECINI112 Title amp Variables amp FName amp ScratchDir amp FileType amp Debug amp VIsDouble CHARACTER Title CHARACTER Variables CHARACTER ScratchDir CHARACTER FName INTEGER 4 FileType INTEGER 4 Debug INTEGER 4 VIsDouble C Syntax include TECIO h INTEGER4 TECINI112 char Title char Variables char FName char ScratchDir INTEGER4 FileType INTEGER4 Debug INTEGER4 VIsDouble 1 if unsuccessful TECLAB112 Parameters Parameter Description Title Title of the data set Must be null terminated Variabl List of variable names Ifa comma appears in the string it will be used as t
8. amp ShrConn Step 3 Define the node numbering for Zone 1 For this example we will create 2 rectangular cells in Zone 1 Before defining your variables you must establish a consistent node numbering scheme for your data Once the node numbers are defined supply the variable values in the node numbering order In this example Node 1 is defined at X 0 and Y 0 As such the first value supplied for X i e X 0 is 0 Similarly the first value supplied for Y is 0 It is important that you refer to node numbers consis tently The node numbers will be used later to define the connectivity for each element For this example we will create two quadrilateral elements The node numbering for the elements is defined in the following picture Step 4 Set up the variable values The variable values will be written to the file using TECDAT Because we are specifying nodal variables as specified via the ValueLocation parameter in TECZNE each variable is dimensioned by the number of points NumPts in the Zone You have the option to specify some variables with TECZNE112 nodal values and some with cell centered values Refer to the Section TECZNE112 on page 53 for details 70 Examples Step 5 Define the connectivity list for Zone 1 The Connectivity List is used to specify the nodes that compose each element When working with nodal variables the numbering of the nodes is implicitly defined w
9. 4 2 Syntax Rules amp Limits An ASCII data file begins with a file header defining a title for the data file and or the names of the variables The header is followed by zone records containing the plot data Zone records may contain ordered or finite element data You may also include text geometry and custom label records that create text geometries and or custom labels on plots The records in the file may be in any order ASCII data files have the following limits Number of Records Each data file may have ten custom label records and any number of text and geometry records e Maximum Characters per Line The maximum length of a line in a data file is 32 000 characters There are additional limits specific to some of the record types and parameters These limits are discussed in the section for the associated record type or parameter 149 ASCII Data When writing an ASCII data file please keep the following syntax rules in mind Character Strings Double quotes must be used to enclose character strings with embedded blank spaces or other special characters e Multiple Lines Any line may be continued onto one or more following lines except for text enclosed in double quotes Escape Characters A backslash 1 may be used to remove the significance of or escape the next character that is produces a single double quote e Comments Any line beginning with an is treated as a commen
10. mml x 156 f B R N n N3 6 NX n2 ni Tetrahedral connectivity arrangement Brick connectivity arrangement Figure 2 3 Connectivity arrangements for FE volume datasets In the brick format points may be repeated to achieve 4 5 6 or 7 point elements For example a connectivity list of n1 n1 n1 n1 n5 n6 n7 n8 where n1 is repeated four times results in a quadrilateral based pyramid element 2 2 4 Finite Element Data Limitations Working with finite element data has some limitations e XY plots of finite element data treat the data as I ordered that is the connectivity list is ignored Only nodes are plotted not elements and the nodes are plotted in the order in which they appear in the data file e Index skipping in vector and scatter plots treats finite element data as I ordered the connectivity list is ignored Nodes are skipped according to their order in the data file 2 3 Variable Location Cell Centered or Nodal Add ons must be aware of the data value location Data values can be stored at the nodes or at the cell centers For finite element meshes cell centers are the centers centroids of elements For many types of plots cell centered values are interpolated to the nodes internally Because the offset into the data is different for nodal values and cell centered values you must know ahead of time how the values
11. 176 Ordered Data IJ Ordered Data Simple Example There are four variables X Y Temperature Pressure and six data points Figure 4 4 An IJ ordered data set In this example each column of data corresponds to a data point each row to a variable VARIABLES X Y Temperature Pressure ZONE I 2 J 3 DATAPACKING BLOCK 372615 024689 001011 50 43 42 37 30 21 In BLOCK format all Max JMax values of each variable are listed one variable at a time Within each variable block all the values of a variable at each data point are listed FORTRAN Code The following sample FORTRAN code shows how to create IJ ordered data in BLOCK format INTEGER VAR WRITE ZONE DATAPACKING BLOCK I IMAX J JMAX DO 1 VAR 1 NUMVAR DO 1 J 1 JMAX DO 1 I 1 IMAX WRITE ARRAY VAR I J 1 CONTINUE 177 ASCII Data IJK Ordered Data Simple Example An example of IJK ordered data in BLOCK format is listed below There are four variables x Y Z Temperature and twelve data points This data is plotted in Figure 4 5 each data point is labeled with its IJK index Figure 4 5 An IJK ordered data set For this example each column of data corresponds to a data point each row to a variable VARIABLES x Y Z Temp ZONE I 3 J 2 K 2 DATAPACKING BLOCK 036036036036 000666000 6 6 6 01334680911 11 12 14 0 5 10 10 41 72 0 29 66 66 130 169 FORTRAN Code The followi
12. ASCII Data e Numerical values in zone data must be separated by one or more spaces commas tabs new lines or carriage returns Blank lines are ignored Integer 101325 floating point 101325 0 and exponential 1 01325E 05 numbers are accepted e To repeat a particular number in the data precede it with a repetition number as follows Rep Num where Rep is the repetition factor and Num is some numeric value to be repeated For example you may represent 37 values of 120 5 followed by 100 values of 0 0 as follows 37 120 5 100 0 0 Variable Sharing Frequently some variables are exactly the same for a set of zones For example a series of zones may contain measurement or simulation data at the same XYZ locations but different times In this case Tecplot 360 s memory usage may be dramatically reduced by sharing the coordinate variables between the zones The zones that variables are shared from are specified in the VARSHARELIST in the control line of the current zone The format is VARSHARELIST set of vars zzz set of vars zzz where set of vars is the set of variables that are shared and zzz is the zone they are shared from If zzz is omitted the variables are shared from the previous zone For example VARSHARELIST 4 6 11 3 20 23 1 13 15 specifies that variables four five six and 11 are shared from zone three variables 20 21 22 and 23 are shared from zone one and variables 13 and 15
13. Figure 4 8 Plot of a 3D volume 4 5 Finite Element Data The zone header for a finite element zones lists the zone type along with the number of nodes ele ments and faces included in the zone The following zone types are available for finite element data FELINESEG FE line segments zones contain one dimensional finite element zones For the line segment element type each line of the connectivity list contains two node numbers that define a linear element e FETRIANGLE FE triangular zones contain two dimensional finite elements defined by three nodes For the triangle element type each line of the connectivity list contains three node numbers that define a triangular element 183 ASCII Data e FEQUADRILATERAL FE quadrilateral zones contain two dimensional elements defined by four nodes For the quadrilateral element type each line of the connectivity list contains four node numbers that define a quadrilateral element If you need to mix quadrilateral and triangle ele ments either use the polygonal zone type or use the quadrilateral element type with node numbers repeated to form triangles FEPOLYGON FE polygonal zones contain two dimensional elements defined by a varying number of nodes three or greater FETETRAHEDRON FE tetrahedral zones contain three dimensional elements defined by four nodes FEBRICK FE brick zones contain three dimensional elements defined by eight nodes Tecplot 360 divides
14. for information on working with auxiliary data in binary or ASCII data files respectively For a list of auxiliary data names see Chapter 12 Auxiliary Data in the ADK User s Manual 5 Data Sharing Share variables whenever possible Variable sharing is commonly used for the spatial variables X Y and Z when you have many sets of data that use the same basic grid This saves disk space as well as memory when the data is loaded into Tecplot 360 In addition the benefits are compounded with scratch data derived from these variables because it is also shared within Tecplot 360 See also Section TECZNE112 on page 53 for binary data or Section 4 5 1 Variable and Connectivity List Sharing for ASCII data 6 Passive Variables Tecplot 360 can manage many datasets at the same time However within a given dataset you must supply the same number of variables for each zone In some cases you may have data where there are many variables and for some of the zones some of those variables are not important If that is the case you can set selected variables in those zones to be passive A passive variable is one that will always return the value zero if queried e g in a probe but will not involve itself in operations such as the cal culations of the min and max range This is very useful when calculating default con tour levels 1 3 Recent Bug Updates FORTRAN users may run into an off by one
15. has passive variables 0 INT32 NV Is variable passive 0 no 1 yes Omit entirely if Has passive variables is 0 INT32 Has variable sharing 0 no 1 yes if has variable sharing 0 INT32 NV Zero based zone number to share variable with relative to this datafile 1 no sharing Omit entirely if Has variable sharing is 0 INT32 Zero based zone number to share connectivity list with 1 no sharing FEPOLYGON and FEPOLYHEDRON zones use this zone number to share face map data Compressed list of min max pairs for each non shared and non passive variable For each non shared and non passive variable as specified above FLOAT64 Min value FLOAT64 Max value zXxxxxxxxx Zone Data Each variable is in data format as specified above specific to ordered zones if zone number to share connectivity list with 1 amp amp num of misc user defined face neighbor connections 0 INT32 N Face neighbor connections Pp nn N number of miscellaneous user defined face neighbor connections P See note 5 below specific to fe zones if ZoneType is NOT FEPOLYGON or FEPOLYHEDRON if zone number to share connectivity lists
16. Tecplot Enjoy the View Tec LoT 360 2008 Data Format Guide Release 2 Tecplot Inc Bellevue WA 2008 COPYRIGHT NOTICE Tecplot 360 Data Format Guide is for use with Tecplot 360 Version 2008 R2 Copyright 1988 2008 Tecplot Inc All rights reserved worldwide Except for personal use 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 Tecplot Inc 3535 Factoria Blvd Ste 550 Bellevue WA 98006 U S A The software discussed in this documentation and the documentation itself are furnished under license for utilization and duplication only according to the license terms The copyright for the software is held by Tecplot Inc Documentation is provided for information only It is subject to change without notice It should not be interpreted as a commitment by Tecplot Inc Tecplot Inc assumes no liability or responsibility for documentation errors or inaccuracies Tecplot Inc Post Office Box 52708 Bellevue WA 98015 2708 U S A Tel 1 800 763 7005 within the U S or Canada 00 1 425 653 1200 internationally email sales tecplot com support tecplot com Questions comments or concerns regarding this document documentation tecplot com For more information visit http www tecplot com THIRD PARTY SOFTWARE COPYRIGHT NOTICES SciPy 2001 2002 Enthought Inc All Rights Reserved
17. 1325 N 121 25 110 28 75 875 10 10 7625 65 os 5975 25 3125 0 0 l N 0 0 0 25 0 0 0 5 1 0 1 0 0 5 0 0 0 5 1 0 Pressure 2 Pressure 3 188 75 188 75 1775 1775 166 25 166 25 155 155 15 143 75 15 143 75 1325 1325 12125 12125 110 10 DA 98 75 9875 875 875 10H 7625 1o 76 25 65 65 53 75 53 75 425 425 31 25 3125 05H os og Figure 4 10 A plot of finite element zones TITLE Example Variable and Connectivity List Sharing VARIABLES X Y pP ZONE T P_1 DATAPACKING POINT NODES 6 ELEMENTS 4 ZONETYPE FETRIANGLE 1 0 0 0 100 0 0 0 0 125 1 0 0 0 150 0 5 0 8 150 0 5 0 8 175 0 0 1 6 200 UWDNDH ou UN ANARA ZONE T P_2 DATAPACKING POINT NODES 6 ELEMENTS 4 ZONETYPE FETRIANGLE VARSHAREL ST 1 2 1 CONNECTIVITYSHAREZONE 1 110 135 160 165 185 200 ZONE T P_3 DATAPACKING POINT NODES 6 ELEMENTS 4 ZONETYPE FETRIANGLE VARSHAREL ST 1 2 1 CONNECTIVITYSHAREZONE 1 120 145 180 175 195 200 186 Finite Element Data 4 5 2 Finite Element Data Set Examples Creating a finite element data set is generally more complicated than creating a similar sized ordered data set In addition to specifying all the data points you must also specify the connectiv ity list Consider the data shown in Table 4 2 Table 4 2 finite element Data
18. 172 ASCII File Structure DATASETAUXDATA Date August 5 2003 DATASETAUXDATA Region NE Quadrant of Sector 47 You may then use the numerical values in equations to modify the variables as follows P P_non dim AuxDataSet RefPressure Similar principles apply when using auxiliary data in text boxes or labels 4 3 7 Variable Auxiliary Data Record Variable auxiliary data is added to Tecplot 360 on a per variable basis Like dataset auxiliary data multiple items can be added for each variable VARAUXDATA 1 MyData Hello VARAUXDATA 1 MoreData World VARAUXDATA 2 MyData More information VARAUXDATA 2 MoreData hi mom VARAUXDATA 2 MyExtraData Some extra data The variable number with which the auxiliary data is associated immediately follows the VARAUXDATA record Also note that the data associated with a particular auxiliary data name are unique for each variable Therefore the same named item can be added to each variable if desired Conversely a particular auxiliary data item can be added to only one variable NOTE The name of an auxiliary data record cannot contain spaces 4 3 8 ASCII Data File Parameter Assignment Values The following parameters assignment values are shared among the following types of ASCII file records Zone Record Text Record and or Geometry Record Refer to those sections for details lt arrowheadstyle gt PLAIN HOLLOW FILLED lt arrowheadattach gt NONE BEGINNIN
19. 213 Binary Data File Format INT32 Number of points line 1 GTYPE N X block geometry points N NumPts GTYPE N Y block geometry points N NumPts GTYPE N Z block geometry points N NumPts Grid3D Only If the geometry type is Rectangle then GTYPE 2 X and Y offset for far corner of rectangle If the geometry type is Circle then GTYPE Radius If the geometry type is Square then GTYPE width If the geometry type is Ellipse then GTYPE 2 X and Y Radii vi Text FLOAT32 Text marker Value 499 0 INT32 Position CoordSys 0 Grid 1 Frame 2 FrameOffset not used 3 OldWindow not used 4 Grid3D New to V10 INT32 Scope 0 Global 1 Local FLOAT64 3 X or Theta Y or R Z or dummy SS Starting Location INT32 FontType INT32 Character Height Units 0 Grid 1 Frame 2 Point 214 INT32 N Height of characters Text Box type 0 NoBox 1 Hollow 2 Filled Text Box Margin Text Box Margin Linewidth Text Box Outline Color Text Box Fill Color Angle Line Spacing Text Anchor O left 1 center 2 right 3 midleft 4 midcenter 5 midright 6 headleft 7 head
20. Examples Step 11 Specify boundary connections for Zone 2 The last step for creating Zone 2 is to specify the boundary connections 103 TECZNE112 Step 12 Close the file Call TECEND to close the file 3 9 4 Multiple Polygonal Zones The following example demonstrates how to create multiple polygonal zones The example covers creating a zone where each element contains a different number of nodes boundary connections and varying variable locations cell centered versus nodal 104 Examples The code in this example produces the following plot Before beginning to create a polyhedral data file you should assign a number to each node face element and zone The numbering system is used to determine the order that the information is sup plied to Tecplot You may assign any order you would like However once you have supplied infor 105 TECZNE112 mation to Tecplot you cannot change the number configuration For this example we have selected the numbering system shown below Zonet 2 x 3 7 4 Ga e 3 10 De Sy A e 2 1211 Zone 1 has a total of three elements thirteen unique nodes and fifteen faces Zone 2 has two ele ments twelve nodes and thirteen faces In order to keep the example as simple as possible error checking is not included If you plan to compile this example be sure to include TECIO h and malloc h The source file
21. FEPOLYGON 184 FEPOLYHEDRAL 184 FEQUADRILATERAL 184 FETETRAHEDRON 184 FETRIANGLE 183 223 INDEX 224
22. Tecplot 360 draws connections from each node to three other nodes You can think of the first four nodes in the element as the bottom layer of the brick and the second four nodes as the top Within the bottom or top layer nodes are connected cyclically 1 2 3 4 1 5 6 7 8 5 the layers are connected by connecting corresponding nodes 1 5 2 6 3 7 4 8 Figure 4 9 illustrates this basic connectivity When you are creating your own connectivity lists for brick elements you must keep this basic connectivity in mind particularly when using 195 ASCII Data duplicate nodes to create pyramids and wedges Tecplot 360 lets you create elements that violate this basic connectivity but the result will probably not be what you want The data file in POINT format is included in your distribution examples dat febrfep dat and is shown below TITLE Example FE Volume Brick Data VARIABLES X Y Z Temperature ZONE NODES 14 ELEMENTS 5 DATAPACKING POINT ZONETYPE FEBRICK 0 9 5 14 15 16 15 17 17 17 18 20 INNNNPPPOOOPPOOO POOOOOOOoOO0000000 UUOUOWUWWMOOUNOO 10 11 8 10 13 14 11 9 12 13 10 76910 The same data in BLOCK format is included in your distribution examples dat febrfeb dat and is shown below DPEPPEPDHDDDNDNDNDNDDNDDNDNDDNDHHRRM NAERAHO0000000000000 PPUUHOHDNDOHDNDOHDNDOHOHO BBUWHOO000000000000 TITLE Example FE Volume Brick Data VARIABLES X Y Z Temperat
23. and the elements are triangles rather than quadri laterals 1 0 1 2 3 4 x Figure 2 2 Triangulated data from Table 4 2 of the Data Format Guide 2 5 2 Example Unorganized Three Dimensional Volume To use 3D volume irregular data in field plots you must interpolate the data onto a regular IJK ordered zone Tecplot 360 does not have a 3D equivalent for triangulation To interpolate your data perform the following steps 1 Place your 3D volume irregular data into an I ordered zone in a data file 19 Data Structure Read in your data file and create a 3D scatter plot From the Data menu choose Create Zone gt Rectangular Circular will also work In the Create Rectangular Zone dialog enter the I J and K dimensions for the new zone at a minimum you should enter 10 for each dimension The higher the dimensions the finer the interpolation grid but the longer the interpolating and plot ting time Enter the minimum and maximum X Y and Z values for the new zone The default values are the minimums and maximums of the current irregular dataset 6 Click Create to create the new zone and Close to dismiss the dialog 7 From the Data menu choose Interpolate gt Kriging Linear or Inverse distance 9 Interpolation also work In the Kriging dialog choose the irregular data zone as the source zone and the newly created IJK ordered zone as the destination zon
24. bug in the runtime version of the library that shipped with Tecplot 360 2008 December 2007 You can download the corrected precompiled libraries from http www tecplot com support tecio aspx Introduction 10 Chapter 2 Data Structure Tecplot 360 accommodates two different types of data Ordered Data and Finite Element Data A connectivity list is used to define which nodes are included in each element of an ordered or cell based finite element zone You should know your zone type and the number of elements in each zone in order to create your connectivity list The number of nodes required for each element is implied by your zone type For example if you have a finite element quadrilateral zone you will have four nodes defined for each element Like wise you must provide eight numbers for each cell in a BRICK zone and three numbers for each element in a TRIANGLE zone If you have a cell that has a smaller number of nodes than that required by your zone type simply repeat a node number For example if you are working with a finite element quadrilateral zone and you would like to create a triangular element simply repeat a node in the list e g 1 4 5 5 In the example below the zone contains two quadrilateral elements Therefore the connectivity list must have eight values The first four values define the nodes that form Element 1 Similarly the second four values define the nodes that form Element 2
25. e Section 3 9 2 Polygonal Example e Section 3 9 3 Multiple Polyhedral Zones e Section 3 9 4 Multiple Polygonal Zones 46 TECTXT112 e Section 3 9 5 Polyhedral Example Adds a text box to the file FORTRAN Syntax INTEGER 4 FUNCTION TECTXT112 rmammmmmmmmmmmmmmmmmmm DOUBLE PRECISION DOUBLE PRECISION DOUBLE PRECISION INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 DOUBLE PRECISION INTEGER 4 DOUBLE PRECISION DOUBLE PRECISION INTEGER 4 INTEGER 4 DOUBLE PRECISION INTEGER 4 DOUBLE PRECISION INTEGER 4 INTEGER 4 INTEGER 4 CHARACTER CHARACTER TECTXT112 XOrThetaPos YOrRPos ZOrUnusedPos PosCoordMode amp AttachToZone Zone Font FontHeightUnits FontHeight BoxType BoxMargin BoxLineThicknessness BoxColor BoxFillColor Angle Anchor LineSpacing TextColor Scope Clipping Text MFC XOrThetaPos YOrRPos ZOrUnusedPos PosCoordMode AttachToZone Zone Font FontHeightUnits FontHeight BoxType BoxMargin BoxLineThicknessness BoxColor BoxFillColor Angle Anchor LineSpacing TextColor Scope Clipping Text MFC TECTXT112 C Syntax include TECIO h INTEGER4 TECTXT112 double double double INTEGER4 INTEGER4 INTEGER4 INTEGER4 INTEGER4 double INTEGER4 double double INTEGER4 INTEGER4 double INTEGER4 double INTEGER4 INTEGER4 INTEGER4 Char Char Return Value 0 if successful 1 if
26. for I 1 I lt Max 1 I Data I J K Var value N varies fastest then Vars That is the num Finite ele IMax i e Num bers should be supplied in the following order ment Nodal 1 Nodes Num for Var 1 Var lt Num Vars Var Vars for N 1 N lt NumNodes N Data N Var value Vars varies fastest then N That is the num Finite ele IMax i e Num bers should be supplied in the following order mient Nodal 0 Nodes Num for N 1 N lt NumNodes N Vars for Var 1 Var lt NumVars Var Data Var N value E varies fastest then Var That is the numbers ar JMax i e should be supplied in the following order oat ele ria 1 NumElements for Var 1 Var lt Num Vars Var NumVars for E 1 E lt NumElements E Data E Var value Table 3 1 Data Arrangement a Cell centered data must be supplied in block format i e IsBlock 1 for all cell centered data Example Refer to the following examples in Section 3 9 Examples for examples using TECDAT112 e Section 3 9 1 Face Neighbors e Section 3 9 2 Polygonal Example e Section 3 9 3 Multiple Polyhedral Zones e Section 3 9 4 Multiple Polygonal Zones e Section 3 9 5 Polyhedral Example e Section 3 9 6 IJ ordered zone 32 TECEND112 TECEND112 Must be called to close out the current data file There must be one call to TECEND112 for each TECINI112 FORT
27. linespacing parameter The default value 1 gives single spacing Use 1 5 for line and a half spacing 2 for double spacing and so on lt double gt Specify the height measured in the units defined by HU HU lt heightunits gt Units for character heights If the CS parameter is FRAME you can set HU to either FRAME or POINT If the CS parameter is GRID you can set HU to either GRID or FRAME MFC lt string gt Attach a macro function to the text The macro function must be a retained macro function that was either set during the current Tecplot session or included in the tecplot mcr file Refer to Section 18 5 Text and Geometry Links to Macros in the User s Manual and MACROFUNCTION ENDMACROFUNCTION in the Scripting Guide for additional information CLIPP ING lt clipping gt Plot the geometry within to the viewport or the frame Figure 4 2 E E Headleft Headcenter E Headright Midleft m Midcenter Mi dright y Left 2 Center a Right Text anchor positions values for the AN parameter 167 ASCII Data Text Record Examples Some simple examples of text records are shown below The first text record specifies only the origin and the text The next text record specifies the origin color font and the text The third text record spec
28. the zone number of the nth neighboring cell in the GLOBALONETOMANY list crn the cell number in the remote zone of the nth neighboring cell in the 162 ASCII File Structure The cz z combinations must be unique multiple entries are not allowed The face numbers for cells in the various zone types are defined in Figure 4 1 08 m7 n 3 n3 f4 f2 n l n1 fl n2 A IM n2 B C Figure 4 1 A Example of node and face neighbors for an fe brick cell or IJK ordered cell B Example of node and face numbering for an IJ ordered cell C example of tetrahedron face neighbors A connection must be specified for two matching cell faces to be effective The nature of the Face Neighbor Connections list depends upon its FACENEIGHBORMODE For example for data with a FACENEIGHBORMODE Of GLOBALONETOONE if cell six face two in zone nine should be connected to cell one face four in zone 10 the connections for zone nine must include the line 6 2 10 1 cell face connecting zone connecting cell And the connections for zone 10 must include this line 1496 cell face connecting zone connecting cell Global face neighbors are useful for telling Tecplot 360 about the connections between zones This could be used for example to smooth out the crease in Gouraud surface shading at zone bound aries For cell centered data they can make contours and streamtraces more continuous at zon
29. 0 1 0 0 0 1 0 1 0 0 0 1 0 1 0 0 0 1 0 1 0 1 0 ZONE T MIXED NODES 6 ELEMENTS 4 DATAPACKING POINT ZONETYPE FEQUADRILATERAL 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 0 0 0 0 2 0 1 0 0 0 2 0 1522 2563 3466 4156 1 1 0 5 0 5 11 x 0 Y Figure 4 15 Three dimensional mesh plot of finite element surface data 194 Finite Element Data FE Volume Data Files Finite element volume data in Tecplot 360 is constructed from either tetrahedra having four nodes or bricks having eight nodes Bricks are more flexible because they can be used through the use of repeated nodes in the connectivity list to construct elements with fewer than eight nodes and combine those elements with bricks in a single zone Finite Element Volume Brick Data Set As a simple example of finite element volume brick data consider the data in Table 4 4 The data can be divided into five brick elements each of which is defined by eight nodes Table 4 4 Finite Element Volume Brick Data Set Data with 14 nodes and four variables X Y Z Temperature 0 0 0 0 0 0 9 5 1 0 1 0 0 0 14 5 1 0 0 0 0 0 15 0 1 0 1 0 1 0 16 0 1 0 0 0 1 0 15 5 2 0 2 0 0 0 17 0 2 0 1 0 0 0 17 0 2 0 0 0 0 0 17 5 2 0 2 0 1 0 18 5 2 0 1 0 1 0 20 0 2 0 0 0 1 0 17 5 2 0 2 0 2 0 18 0 2 0 1 0 2 0 17 5 2 0 0 0 2 0 16 5 In each element s connectivity list
30. 0 1 0 3 0 0 0 1 0 3 0 4 0 2 0 1 0 1 0 1 0 0 0 0 0 0 0 0 0 2 0 100 0 150 0 300 0 50 0 100 0 200 0 400 0 280 0 1 6 1 5 2 0 1 0 1 4 2 2 3 0 1 9 1254 2365 6733 3288 In BLOCK format all values for a single variable are written in a single block The length of the block is the number of data points in the zone In POINT format all variables for a single data point are written in a block with the length of the block equal to the number of variables The connectivity list is the same for both POINT and BLOCK formats You can change the connectivity list to obtain a different mesh for the same data points In the above example substituting the following connectivity list yields the five element mesh shown in 188 Finite Element Data Figure 4 12 You must also change the ELEMENTS parameter in the zone control line to specify five elements 1 E 3 4 Figure 4 12 Finite element data of Figure 4 11 with a different connectivity list WOU RR NAIWND oowoaWw e owoauM 189 ASCII Data Two Dimensional Field Plots A 2D finite element data file is shown below included in your Tecplot 360 distribution as exam ples dat 2dfed dat 3 2 gt 4 1 2 3 4 x Figure 4 13 A 2D field plot TITLE Example 2D Finite Element Data VARIABLES X Y P T ZONE NODES 8 ELEMENTS 4 DATAPACKING POINT ZONETYPE FEQUADRILATERAL 75 0 1 6 100 0 1 5 WANPNIARPOURO DNSWDOOOOOOOOoO OoWNUDO
31. 1 0 1 12 The data file in POINT format for the data in Table 4 5 is shown below and plotted in Figure 4 17 TITLE Example FE Volume Tetrahedral Data VARIABLES X Y 2 C U WV WN ZONE NODES 13 ELEMENTS 20 DATAPACKING POINT ZONETYPE FETETRAHEDRON 00 95 1108 0 85 42 0 85 3 9 81 26 42 2 22 80 8 50 69 42 6 72 52 9 50 69 42 14 67 48 9 81 26 42 20 30 82 9 0 001 2 5 10 50 69 43 14 68 48 11 81 26 43 20 31 82 11 0 85 43 0 84 3 10 81 26 43 2 21 80 11 50 69 43 6 71 51 11 096 10 1 12 SI PPP00OGQUIAUYDN YN Oo OB W ODRFAOUBWNHRPRRPRRO 12 8137 89137 9 10 13 7 10 11 13 7 11 12 13 7 198 Finite Element Data gt Figure 4 17 Finite element volume tetrahedral data This data file is included in your Tecplot 360 distribution s examples dat directory as the file fetetpt dat A block format version of the same data is included as the file fetetbk dat Polygonal simple example A polygonal element in one zone connected to an element in another zone Node3 Elementl Zone2 Nodel Facel Node2 Zone ZoneType FEPolygon Nodes 3 Faces 3 Elements 1 NumConnectedBoundaryFaces 2 TotalNumBoundaryConnections 1 variable values in block format face nodes 12 23 31 left elements 111 199 ASCII Data right elements negative indicates boundary connections 0 10 boundary connectio
32. Block Nodal Block Cell centered Point Nodal The combination of POINT and CELLCENTERED is not available BLOCK NODAL In block data with nodal values the data is arranged by variable and each variable is defined at the nodes The data arrangement is as follows Al Aj Ajp A gt Ay App Ay Ann Ayp where V total number of nonpassive nonshared variables P I J RK ordered zones or NODES FE zones 158 ASCII File Structure BLOCK CELLCENTERED In block data with cell centered values the data is arranged by variable and each variable is defined at the center of each cell ORDERED data or element FE data The data arrangement is as fol lows Al An Alp A gt Ay Ap Av Av Ayp where V total number of nonpassive nonshared variables P 1 1 J 1 K 1 ordered zones or P ELEMENTS FE zones 1 For all I J and K greater than one When I J or K is equal to one a value of one is used instead of subtracting one POINT NODAL In point data the values for all variables are given for the first point then the second point and so on The variable location is always NODAL Aj Aj Aly A gt 1 Ao Ay Ap Am Apy where V total number of nonpassive nonshared variables P I J RK ordered zones or P ELEMENTS FE zones General Formatting Rules The following formatting guidelines apply to all data arrangements 159
33. Element 1 Element 2 The connectivity list for this example would appear as follows ConnList 8 4 5 2 1 nodes for Element 1 11 Data Structure 5 6 3 2 nodes for Element 2 It is important to provide your node list in either a clockwise or counter clockwise order Otherwise your cell will twist and the element produced will be misshapen 2 1 Ordered Data Ordered data is defined by one two or three dimensional logical arrays dimensioned by IMAX JMAX and KMAX These arrays define the interconnections between nodes and cells The vari ables can be either nodal or cell centered Nodal variables are stored at the nodes cell centered values are stored within the cells One dimensional Ordered Data I ordered J ordered or K ordered A single dimensional array where either IMAX Nodal Values are Stored Here JMAX or KMAX is greater than or equal to one and 2 the others are equal to one For nodal data the number y a of stored values is equal to IMAX JMAX KMAX e e For cell centered I ordered data where IMAX is N J greater than one and JMAX and KMAX are equal to _ one the number of stored values is IMAX 1 simi sonen S I for J ordered and K ordered data Two dimensional Ordered Data IJ ordered JK ordered IK ordered A two dimensional array where two of the three euer S dimensions IMAX JMAX KMAX are greater than one and the other dimension is equal to on
34. I index varies the fastest the J index the next fastest the K index the slowest If you write a program to print IJK ordered data the I index is the inner loop the K index is the outer loop and the J index is the loop in between Note the similarity between IJ ordered data and IJK ordered data with KMax 1 4 4 4 Ordered Data Examples The following examples are provided for your reference J Ordered Data Simple example 1J Ordered Data Simple Example e IJK Ordered Data Simple Example e Multi Zone XY Line Plot e Multi Zone XY Line Plot with Variable Sharing Example e Cell Centered Data e Two Dimensional Field Plots Three Dimensional Field Plots e Polygonal simple example e Polyhedral complex example 175 ASCII Data I Ordered Data Simple example This data set is plotted in Figure 4 3 each data point is labeled with its I index 50F 5 Figure 4 3 An J ordered data set In this example each column of zone data corresponds to a data point each row to a variable VARIABLES X Y ZONE I 5 DATAPACKING BLOCK 23567 4 9 25 36 49 In BLOCK format all values of each variable are listed one variable at a time FORTRAN Code The following sample FORTRAN code shows how to create I ordered data in BLOCK format INTEGER VAR WRITE ZONE DATAPACKING BLOCK I IMAX DO 1 VAR 1 NUMVAR DO 1 I 1 IMAX WRITE ARRAY VAR 1 1 CONTINUE
35. IJ ordered data with cell centered variables might include four variables X Y Temperature Pressure nine data points and four cells where Temperature and Pressure are cell centered Figure 4 7 An IJ ordered data set with cell centered VARIABLES X Y Temperature Pressure ZONE I 3 J 3 DATAPACKING BLOCK VARLOCATION 3 4 CELLCENTERED 37112610159 0234688910 0213 45 60 35 70 The nodal variables of x and Y are specified at all nine nodes and the values of cell centered vari ables are specified at the four cells IMax 1 JMax 1 Zones with cell centered data must have DATAPACKING BLOCK Two Dimensional Field Plots A 2D field plot typically uses an IJ ordered or finite element surface data set However any data structure can be viewed as a 2D field plot by simply selecting 2D Cartesian from the plot type menu in the Sidebar An IJ ordered data file has the basic structure shown below TITLE Example Multi Zone 2D Plot VARIABLES X Y Press Temp Vel ZONE T BIG ZONE I 3 J 3 DATAPACKING POINT 1 0 2 0 100 0 50 0 1 0 1 0 3 0 95 0 50 0 1 00 1 0 4 0 90 0 50 0 0 90 181 ASCII Data 2 0 2 0 91 0 40 0 0 90 2 0 3 0 85 0 40 0 0 90 2 0 4 0 80 0 40 0 0 80 3 0 2 0 89 0 35 0 0 85 3 0 3 0 83 0 35 0 0 80 3 0 4 0 79 0 35 0 0 80 ZONE T SMALL ZONE I 3 J 2 DATAPACKING POINT 3 0 2 0 89 0 35 0 0 85
36. IJK ordered zone within Tecplot 360 In I ordered data the I index varies from one to Max The total number of data points is Max For zones with only nodal variables the total number of values in the zone data is Max N where N is the number of variables For a mixture of nodal and cell centered variables the number of values in the zone data is Max Nn IMax 1 Nc where Nn is the number of nodal variables and Nc is the number of cell centered variables For data in POINT format Max is calculated by Tecplot 360 from the zone data if it is not explicitly set by the zone control line using the I parameter 4 4 2 IJ Ordered Data IJ ordered data has two indices I and J IJ ordered data is typically used for 2D and 3D surface mesh contour vector and shade plots but it can also be used to plot families of lines in XY plots Refer to Chapter 3 Data Structure in the User s Manual for more information on data structure In IJ ordered data the I index varies from one to Max and the J index varies from one to JMax The total number of data points nodes is Max JMax For zones with only nodal variables the total number of numerical values in the zone data is Max JMax N where N is the number of vari ables For a mixture of nodal and cell centered variables the number of values in the zone data is IMax JMax Nn IMax 1 JMax 1 Nc where Nn is the number of nodal variables and Nc is the number of cell centered variables Both
37. IJK ordered zone based on index ranges IJK Ordered A type of data ordering where the points are arranged in a 3D array Used for 3D volume plotting as well as 2D and 3D surface plotting I Plane In an ordered zone the connected surface of all points with a constant I index In reality I planes may be cylinders spheres or any other shape Irregular Data Points which have no order or at least no order which can be easily converted to IJ or IJK ordering In an ordered zone the connected surface of all points with a constant J Plane J index In reality J planes may be cylinders spheres or any other shape K Plane In an IJK ordered zone the connected surface of all points with a con stant K index In reality K planes may be cylinders spheres or any other shape Macro A file containing a list of instructions called macro commands which can duplicate virtually any action performed in Tecplot Macro Command An instruction given to Tecplot in a macro file Macro commands always start with a dollar sign and then an exclamation mark For example Redraw refreshes a plot view Macro File A file which contains a series of macro commands Macro files are run from the command line or through the Play option of the Macro sub menu of the File menu Macro Function A self contained macro sub routine Macro Variable A holding place for numeric values in a m
38. Max and JMax must be specified in the zone control line with the 1 and J parameters The I and J indices should not be confused with the X and Y coor dinates on occasions the two may coincide but this is not the typical case The I index varies the fastest That is when you write programs to print IJ ordered data the I index is the inner loop and the J index is the outer loop Note the similarity between I ordered data and IJ ordered data with JMax 1 174 Ordered Data 4 4 3 IJK Ordered Data IJK ordered data has three indices I J and K This type of data is typically used for 3D volume plots although planes of the data can be used for 2D and 3D surface plots See Section 3 2 Ordered Data in the User s Manual for more information In IJK ordered data the I index varies from one to Max the J index varies from one to JMax and the K index varies from one to KMax The total number of data points nodes is IMax JMax KMax For zones with only nodal variables the total number of values in the zone data is Max JMax KMax N where N is the number of variables For a mixture of nodal and cell cen tered variables the number of values in the zone data is Max JMax KMax Nn IMax 1 JMax 1 KMax 1 Nc where Nn is the number of nodal variables and Nc is the number of cell centered variables The three indices Max JMax and KMax must be specified in the zone control line using the I J and K parameters The
39. NumPy 2005 NumPy Developers All Rights Reserved VisTools and VdmTools 1992 2007 Visual Kinematics Inc All Rights Reserved NCSA HDF amp HDFS Hierarchical Data Format Software Library and Utilities Contributors National Center for Supercomputing Applications NCSA at the University of Illinois at Urbana Champaign UIUC Lawrence Livermore National Laboratory LLNL Sandia National Laboratories SNL Los Ala mos National Laboratory LANL Jean loup Gailly and Mark Adler gzip library Copyright 1998 2006 The Board of Trustees of the University of Illinois Copyright 2006 2008 The HDF Group THG All Rights Reserved PNG Reference Library Copyright 1995 1996 Guy Eric Schalnat Group 42 Inc Copyright 1996 1997 Andreas Dilger Copyright 1998 1999 Glenn Randers Pehrson All Rights Reserved Tel 1989 1994 The Regents of the University of California Copyright 1994 The Australian National University Copyright 1994 1998 Sun Microsystems Inc Copyright 1998 1999 Scriptics Corporation All Rights Reserved bmptopnm 1992 David W Sanderson All Rights Reserved Netpbm 1988 Jef Poskanzer All Rights Reserved Mesa 1999 2003 Brian Paul All Rights Reserved W3C IPR 1995 1998 World Wide Web Consortium Massachusetts Institute of Technology Institut National de Recherche en Informatique et en Automatique Keio University All Rights Reserved Ppmtopict 1990 Ken Yap All Rights Reserved JPEG 1991 1998 Thomas G Lane All Rights Rese
40. Required Default Notes n Y N TEXT Y Keyword required to start a text record T lt string gt Y The text string is defined in the required T text parameter To include multiple lines of text in a single text record include n in the text string to indicate a new line ZN lt integer gt N Use the ZN zone parameter to attach text to a specific zone or XY mapping For further information see Section 18 1 2 Text Options in the User s Manual x lt double gt Y Specify the x origin y origin and z origin of the object y TE Y The x origin and y origin should be in cs coordinatesys units The z origin of object must always in GRID units Zz lt double gt Y R lt double gt Y r origin in CS units of the object THETA lt double gt Y theta origin in CS units of the object cs N FRAME Text coordinate system If you specify the frame lt coordinates coordinate system the values of the X xorigin and Y ys gt yorigin parameters are in frame units if you specify grid coordinates X and Y are in grid units that is units ofthe physical coordinate system Specify X Y and Z for GRID3D coordinates For Polar Line plots you may specify THETA and R instead of X and Y A lt double gt N Use the A parameter to rotate the text box at an angle counter clockwise from horizontal The angle is in units of degrees S lt scope gt N Scope of the text box GLOBAL scope attaches the text box to all frames usi
41. are shared from the previous zone For vari able sharing ordered zones may only share with ordered zones having the same dimensions Finite element zones may share with any zone having the same number of nodes for nodal variables or the same number of cells for cell centered data Zone Footer The contents required for the Zone Footer depend upon the ZONETYPE specified in the Zone Header Ordered zones the Zone Footer contains the Face Neighbor Connections List if any e Cell based finite element zones FETRIANGLE FEQUADILATERAL FETETRAHEDRAL and FEBRICK the Zone Footer contains Connectivity information followed by Face Neighbor Connections List if any Face based finite element zones FEPOLYHEDRAL FEPOLYGON the Zone Footer contains Facemap Data followed by Boundary Map Data 160 ASCII File Structure Connectivity For cell based finite element zones FETRIANGLE FEQUADILATERAL FETETRAHEDRAL and FEBRICK the nodal data is followed by the connectivity information The connectivity list is not preceded by a token or keyword It is simply a list of numbers The connectivity list details the node numbers of all of the nodes included in each element When providing the connectivity list please keep in mind the following guidelines Each row in the connectivity list corresponds to an element where the first row corresponds to the first element and so forth The node numbers must be pr
42. connectivity sharing the zone must have the same number of points and elements and faces if the zone is face based and be the same zone type STRANDID lt integer gt Each zone can optionally specify an integer value associating itself with a particular strand More than one zone can associate itself with a particular strand and differentiate itself from other zones by assigning different SOLUTIONTIME values StrandID s must be positive integer values greater than or equal to 1 By convention strandID s are successive integer values 156 ASCII File Structure Keyword Syntax Required Default Notes Y N SOLUTIONT lt double gt N Specify a floating point time value IME representing the solution time Zones can be organized together by associating themselves to the same STRANDID PARENTZON lt zone gt N Scalar integer value representing the E relationship between this zone and its parent A value of zero indicates that this zone is not associated with a parent zone A value greater than zero is considered this zone s parent A zone may not specify itself as its own parent With a parent zone association Tecplot 360 can generate a surface streamtrace on a no slip boundary zone Refer to Section 15 3 Surface Streamtraces on No slip Boundaries in the User s Manual for additional information AUXDATA NAME N Auxiliary data strings associated with
43. data in three point triangle four point quadrilateral or variable point polygonal elements The number of points per node and their arrangement are determined by the element type of the zone If a mixture of quadrilaterals and triangles is necessary you may repeat a node in the quadrilateral element type to create a triangle or you may use polygonal elements 14 Finite Element Data e Volume data is a set of tetrahedral brick or polyhedral elements defining a 3D volume field When using polyhedral elements the number of sides may vary from element to element Finite element volume cells may contain four points tetrahedron eight points brick or variable points polyhedral The figure below shows the arrangement of the nodes for tetrahedral and brick elements The connectivity arrangement for polyhedral data is governed by the method in which the polyhedral facemap data is supplied AA m7 6 A 55 n6 14 f B zi Yaz A N3 Tetrahedral connectivity arrangement Brick connectivity arrangement Figure 2 2 Connectivity arrangements for FE volume datasets In the brick format points may be repeated to achieve 4 5 6 or 7 point elements For example a connectivity list of n1 n1 n1 n1 n5 n6 n7 n8 where n1 is repeated four times results in a quadrilateral based pyramid element Section 4 5 Finite Element Data in the Data Format Gu
44. depend upon the ZONETYPE specified in the Zone Header For ordered zones the Zone Footer contains the Face Neighbor Connections List information if any For cell based finite element zones FETRI ANGLE FEQUADILATERAL FETETRA HEDRAL and FEBRICK the Zone Footer contains Connectivity information followed by Face Neighbor Connections List For face based finite element zones FEPOLY HEDRAL FEPOLYGON the Zone Footer contains Facemap Data followed by Boundary Map Data Refer to Zone Footer on page 160 for additional informa tion 153 ASCII Data Zone Header Keyword Syntax Required Y N Default Notes ZONE Keyword required to start a zone record T lt string gt Zone Title This may be any text string up to 128 characters in length If you supply a longer text string it is automatically truncated to the first 128 characters The titles of zones appear in the Zone Style and other dialogs and optionally in the XY plot legend ZONETYPE lt zonetype gt ORDERE The zone data are of the type specified by the ZONETYPE parameter in the control line There are two basic types of zones ordered and finite element ORDERED is presumed ifthe ZONETYPE parameter is omitted See Section 4 4 Ordered Data for more information on ordered zones and Section 4 5 Finite Element Data for details on finite element data ZoneType
45. for a description of how to arrange your data IsDouble Pointer to the integer flag stating whether the array Data is single 0 or double 1 preci acia sion Data Arrangement The following table describes the order the data must be supplied given different zone types IsBlock and VarLocation are parameters supplied to TECZNE112 Zone Var IsBlock Number of Order Type Loca Values tion I varies fastest then J then K then Vars That is the numbers should be supplied in the fol IMax lowing order JMax for Var 1 Var lt NumVars Var Ordered ad l KMax for K 1 K lt KMax K NumVars for J 1 J lt JMax J for J 1 I lt IMax I Data I J K Var value Vars varies fastest then I then J then K That is the numbers should be supplied in the fol IMax lowing order JMax for K 1 K lt KMax K a i Modal 0 KMax for J 1 J lt JMax J NumVars for I 1 I lt IMax I for Var 1 Var lt NumVars Var Data Var I J K value Table 3 1 Data Arrangement 31 TECDAT112 Zone Var IsBlock Number of Order Type Loca Values tion I varies fastest then J then K then Vars That is the numbers should be supplied in the fol IMax 1 lowing order Ordered Cell Cen ja JMax 1 for Var 1 Var lt Num Vars Var tered KMax 1 for K 1 K lt KMax 1 K NumVars for J 1 J lt JMax 1 J
46. for polar line plots the or ae Theta position of the geometry ThetaPos YPos Pointer to double value specifying the Y position or for polar line plots the R aad position of the geometry RPos ZPos Pointer to double value specifying the Z position of the geometry Pointer to integer value specifying the position coordinate system 0 Grid PosCoordMode 1 Frame 6 Grid3D Grid3D is available only when the GeomType is equal to 3D Line Segments Pointer to integer flag to signal that the geometry is attached to a zone i it wi isi hen that AttachToZone When a geometry is attached to a zone it will be visible only when that zone is visible 1 Yes 0 No Zone Pointer to integer value specifying the number of the zone to attach to Must be greater than or equal to one Pointer to integer value specifying the color to assign to the geometry 0 Black 8 Custom1 1 Red 9 Custom2 2 Green 10 Custom3 Color 3 Blue 11 Custom4 4 Cyan 12 Custom5 5 Yellow 13 Custom6 6 Purple 14 Custom7 7 White 15 Custom8 Pointer to integer value specifying the color used to fill the geometry Refer to FillColor E Color for a list of available values Pointer to integer flag to specify if geometry is to be filled IsFilled 1 Yes 0 No 39 TECGEO112 Parameter Description Pointer to integer value specifying the geometry type GeomType 0 2D Line Segments 3 Circle yP 1 Rectangle 4 Ellipse 2 Square 5 3D Line Segments
47. list of right neighboring elements for each face RightElementForFace RightElementForFace RightElementForFace y The face map may be shared between zones in the same file o by specifying the zone number of the sharing zone in place of the CONNECTIVITYSHAREZONE value Defining Neighboring Elements 164 ASCII File Structure The left element and right element are determined by the left hand versus right hand winding rule The left and right neighboring elements represent elements within the current zone and they are always one to one That is each face represents a complete interface between two elements A negative value t in either of the neighboring faces lists indicates that the neigh boring element s are defined in the boundary face section at the t boundary face Refer to Section Boundary Map Data for details Any face that has no neighboring element for either its right or left adjacent element will use a value of zero for the element value See also Connectivity Sharing on page 165 Boundary Map Data If the NUMCONNECTEDBOUNDARYFACES is greater than zero the boundary map data section is required The boundary map data section should immediately follow the Facemap Data section This section does not need to be one to one One face can link up to multiple elements in other zones The number of adjacent elements is listed for each of the boundary faces Then each boundary face
48. listed for each node Zones with cell centered variables must be in BLOCK data packing format VARSHAREL Ist set of vars lt zone gt set of vars lt zone gt If zone number is omitted the variables are shared from the previous zone Used for variables that are exactly the same for a set of zones Specify the integer value ofthe source zone Ordered zones may only share with ordered zones having the same dimensions Finite element zones may share with any zone having the same number of nodes for nodal variables or the same number of cells for cell centered data lt integer gt Specifies the variable number of the variable representing the Node value in finite element data The NV parameter is used infrequently It is mostly used when the order in which nodes are listed in the data file does not match the node numbering desired in the plot Refer to Section Finite Element Zone Node Variable Parameters Example on page 192 for an example using the NV parameter CONNECTIV ITYSHAREZ ONE lt zone gt Specify the number of the zone from which the connectivity is shared The connectivity list cell basedfinite element only and face neighbors may be shared between zones using the CONNECTIVITYSHAREZONE parameter in the control line of the current zone Alternatively the parameter may be used to share the Facemap Data for face based finite element zones To use
49. oe to A some variables with nodal values and some with cell centered values Refer to S T NE112 on page 53 for details The order of the values supplied for each nodal variable is determined by the node numbering established in Step 3 The first value for each variable is for Node 1 the second value for each vari able is for Node 2 and so forth V1 ValueAtNodel ValueAtNode2 ValueAtNodeN where N is the total number of nodes 81 TECZNE112 Step 5 Define the Face Nodes The FaceNodes array is used to indicate which nodes define which face As mentioned earlier the number of the nodes is implicitly defined by the order in which the nodal data is provided The first value of each nodal variable describes Node 1 the second value describes Node 2 and so on The face numbering is also implicitly defined Because there are two nodes in each face of any polygonal zone the first two nodes provided define Face 1 the next two define Face 2 and so on If there was a variable aa a nodes used to define the faces the array would be more compli cated Refer to 13 9 ultiple Polygonal Z for an example 82 Examples The following picture describes the face numbering for this example As you can see Face 1 is defined by Nodes 1 and 2 Face 2 is defined by Nodes 2 and 3 and so forth Because of this simple arrangement we can use a for loop to define all but the end points of the face nod
50. of their respective owners NOTICE TO U S GOVERNMENT END USERS Use duplication or disclosure by the U S Government is subject to restrictions as set forth in subparagraphs 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 Tecplot Inc 3535 Factoria Blvd Ste 550 Bellevue WA 98006 U S A 08 360 05 2 Rev 09 2008 Table of Contents Chapter 1 Introduction id 7 Creating Data Files for Both Tecplot 360 amp Tecplot Focus 8 Best PLACE CES cacon ia ci 8 Recent Bug UpdateS cooocconccocciccococnnonccnoncnconnnncononnonncnnonc co nonancn nenas 9 Chapter 2 Data Structure A 11 Ordered Data riada 12 Finite Element Data oonoonocnccnonononnnononnnocnnononononncon non cnnn non nronncnnnnnnnns 13 Line DOUG aii caia 15 Surface DA A A AEE iia 15 Volume DATA dada legen 16 Finite Element Data Limitations ucsaseseseeessesesesnnnennnne one 16 Variable Location Cell Centered or Nodal eneee 16 Face NelghborS uno alada 17 Working with Unorganized Datasets seeen 18 Example Triangulate a Dataset nnseseneneneenesensenneenen 18 Example Unorganized Three Dimensional Volume 19 Time and Date Represe
51. page 33 for details In this case we must supply the following information in the order provided e the cell number in the current zone that contains the face neighbor e the number of the face in that cell that contains the face neighbor e the number of the other zone to which the face is connected e the number of the cell in the other zone to which the face is connected 72 Examples The face numbering for Cell based finite elements is defined using Figure 3 1 on page 35 In this example Face 2 in Cell 2 in the current zone is connected to Cell 1 in Zone 2 Zone 1 Zone 2 Step 7 Create Zone 2 The creation of Zone 1 is complete We are ready to create Zone 2 For simplicity Zone 2 is a copy of Zone 1 shifted along the X axis As such many of the variables used to create Zone are re used here 73 TECZNE112 Step 8 Define the variables for Zone 2 Because Zone 2 is a copy of Zone 1 shifted along the X axis we can share the Y variable defini tion used to Zone We will also create a second pressure variable for Zone 2 P2 74 Examples Step 9 Define the connectivity list for Zone 2 As with Zone 1 we must define the connectivity list for Zone 2 Because the node numbering restarts at one for each new zone and the nodal arrangement is identical between the two zones we may reuse the connectivity list from Zone 1 Step 10 Define the face neighbor connect
52. please note that some features in Tecplot 360are limited by zone type For example iso surfaces and slices are available for 3D zones types only FETETRAHEDRON FEBRICK FEPOLYHEDRON and ORDERED with K greater than 1 However the plot type that you specify in Tecplot 360 once you have loaded your data is not limited by your zone type You may have a 3D zone displayed in a 2D Cartesian plot and visa versa I lt integer gt J lt integer gt K lt integer gt Specify the maximum number of points in the I J or K direction Use only when ZONETYPE is ORDERED NODES lt integer gt ELEMENTS lt integer gt FACES lt integer gt KK KEK KY KX Use for finite element zone types only i e not ordered zones Specify the total number of NODES ELEMENTS and FACES in the data file Refer to Section 4 5 Finite Element Data for additional information TOTALNUMF ACENODES lt integer gt Y for polyhedral zones For face based finite element zones only Total number of nodes in the Facemap Data section for all faces This is optional for polygons as TotalNumFaceNodes 2 NumFaces NUMCONNEC TEDBOUNDA RYFACES lt integer gt For face based finite element zones only Total number of boundary faces listed in the Facemap Data section Set to zero if boundary faces aren t used 154 ASCII File Structure
53. the eight nodes into two groups of four nodes N1y N2y N3y and N4 make up the first group and N5 y N6y N7 and N8 make up the second group where N is the node number and M is the element number Each node is connected to two nodes within its group and the node in the corresponding position in the other group For example N1y is connected to N2y and N4y in its own group and to N5 y in the second group To create elements with fewer than eight nodes repeat nodes as necessary keeping in mind the basic brick connectivity just described Figure 4 9 shows the basic brick con nectivity For example to create a tetrahedron you can set N3y N4 y and N5y N6y N7 N8 To create a quadrilateral based pyramid you can set N5y N6y N7y N8 qq n8 vi no n6 ni n2 Figure 4 9 Basic brick connectivity FEPOLYHEDRAL FE polyhedral zones contain elements with a varying number of faces Each element has at least four faces The faces are defined by any number of nodes with a minimum of three nodes in each face 184 Finite Element Data Refer to Section 4 3 2 Zone Record for a complete list of the tokens included in the zone header After the zone header the nodal data is listed The nodal data contains the value of each variable for each node or element Refer to Section Data on page 158 for details on arranging the data The information following the nodal data is dependent upon the zone t
54. the number of points in each ofthe Num NumSegPts Segments segments 40 TECGEO112 Parameter Description XGeomData ThetaGeomData Array of floating point values specifying the X Y and Z coordinates Refer YGeomData to Data Values on page 41 for information regarding the values required for each GeomType RGeomData ZGeomData MFC Macro function command Must be null terminated Examples Refer to Section 3 9 9 Geometry Example for a simple example of working with TECGEO112 Origin positions The origin XOrThetaPos YOrRPos ZPos of each geometry type is listed below SQUARE lower left corner at XOrThetaPos YOrRPos RECTANGLE lower left corner at XOrThetaPos YOrRPos CIRCLE centered at XOrThetaPos YOrRPos ELLIPSE centered at XOrThetaPos YOrRPos LINE anchored at XOrThetaPos YOrRPos LINE3D anchored at XOrThetaPos YOrRPos ZPos Data Values The origin XOrThetaGeomData YOrRGeomData ZGeomData of each geometry type is listed below SQUARE set XOrThetaGeomData equal to the desired length RECTANGLE set XOrThetaGeomData equal to the desired width and YOrThetaGeomData equal to the desired height CIRCLE set XOrThetaGeomData equal to the desired radius ELLIPSE set XOrThetaGeomData equal to the desired width along the x axis and YOrThetaGeomData equal to the desired width along the y axis
55. time TECINI112 is called it sets up a new file context For each file context you must main tain the order of the calls as described in the previous section The TECFIL112 function is used to switch between file contexts Up to 10 files can be written to at a time TECFIL112 can be called almost anywhere after TECINI112 has been called The only parameter to TECFIL112 an integer n shifts the file context to the nth open file The files are numbered relative to the order of the calls to TECINI112 3 6 Linking with the TecIO Library To output data in Tecplot s binary format you may write your own functions or use the library pro vided with your installation On Windows platforms tecio lib is installed in the bin directory of 26 Linking with the TecIO Library your Tecplot 360 installation On UNIX Linux Macintosh platforms tecio a is installed in the lib directory of your Tecplot 360 installation Follow the instructions below to link with Tecplot s library The plt file that you create will be compatible with the version of Tecplot tied to the version of the TecIO library that you use For example if you use the TecIO library that was bundled with Tecplot 360 Version 2006 your files can be loaded with Tecplot 360 Version 2006 and newer This is independent of the version number used for the binary functions e g the 112 in TECZNE112 For example even if you use 110 functions with the version of the TecIO li
56. tion on linking with the TecIo library 4 Begin developing your code 3 2 Viewing Your Output You may load your binary files in Tecplot using the Tecplot Data loader refer to Section 4 15 Tecplot Format Loader for details In addition you may view information about your data file using any of the following techniques e Pltview Pltview is a command line utility that displays the header information for your file It is installed in TEC_360_2008 bin Refer to Section B 6 Pltview on page 654 in the User s Manual for details on working with pltview e View Binary The ViewBinary add on allows you to view the information in a Tecplot binary data plt file It is included in a standard Tecplot distribution Refer to Section 32 3 19 View Binary on page 635 in the User s Manual for details e Dataset Information dialog You may use the Data Set Information dialog accessed via the Data menu to display information about your plt file once it is loaded into Tecplot Refer to this dialog for a list ofthe zones variables variable ranges auxiliary data and more Refer to Section 5 4 Dataset Information on page 157 in the User s Manual for details e Data Spreadsheet Use the Data Spreadsheet to view a table of every variable value in your file Refer to Section 20 12 Data Spreadsheet in the User s Manual for details 24 Binary Function Notes 3 3 Binary Fu
57. to fully analyze and present the results Auxiliary data are name value pairs that a user can specify and then use in Tecplot 360 with dynamic text equations macros or add ons This data may be with respect to the data set as a whole or it can vary from zone to zone The ASCII file format token for specifying auxiliary data associated with the entire data set is DATASETAUXDATA described here Auxiliary data for a given variable is defined by VARAUXDATA described in Section 4 3 7 Variable Auxiliary Data Record Auxiliary data for a given zone is defined by the AUXDATA token within the zone record refer to Zone Header on page 154 for details The data set auxiliary data control line is as follows DATASETAUXDATA name value where name is a unique character string with no spaces You may have multiple DATASETAUX DATA records However the value of name must be unique for each record Auxiliary data may be used in text macros equations if it is numeric and accessed from add ons It may also be viewed directly in the AuxData page of the Data Set Information dialog Data Set Auxiliary Data Examples The following auxiliary data contain flow field information that might be found in output from a computational fluid dynamics simulation DATASETAUXDATA MachNo 1 2 DATASETAUXDATA Alpha 5 DATASETAUXDATA RefTemperature 250 DATASETAUXDATA RefPressure 101325 DATASETAUXDATA Configuration A2 No 3
58. to resolve this issue Use Block Format instead of Point Format Block format is by far the most efficient format when it comes to loading the file into Tecplot 360 If your data files are small and you can only obtain the data in a point like format e g with a spreadsheet then using point format is acceptable Use the Native Byte Ordering for the Target Machine When you create binary data you can elect to produce these files in either Motorola byte order or Intel byte order Tecplot 360 automatically detects the byte order and loads both types However it is more efficient if you produce files using the byte order used on the platform where you run Tecplot 360 For example if you produce a binary file on an SGI platform and then transfer the data to a Windows platform or Recent Bug Updates Intel based Linux box you should set the flag to reverse the bytes when generating the binary data file See the notes about this option in Section B 4 Preplot in the User s Manual for the Preplot flag 4 Add Auxiliary data to Preset Variable Assignments in Tecplot 360 Zone Auxiliary data can be used to give Tecplot 360 hints about properties of your data For example it can be used to set the defaults for which variables to use for cer tain kinds of plots Auxiliary data is supported by both binary and ASCII formats Refer to Section TECAUXSTR112 on page 28 or Section 4 3 6 Data Set Auxil lary Data Record
59. unsuccessful XOrThetaPos YOrRPosPos ZOrUnusedPos PosCoordMode AttachToZone Zone Font FontHeightUnits FontHeight BoxType BoxMargin BoxLineThicknessness BoxColor BoxFillColor Angle Anchor LineSpacing TextColor Scope Clipping Text MFC 48 TECTXT112 Parameters Parameter Description 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 Pointer to integer value specifying the position coordinate system 0 Grid 1 Frame PosCoordMode 6 Grid3D If you use Grid3D the plot type must be set to 3D Cartesian to view your text box AttachToZone Pointer to integer flag to signal that the text is attached to a zone Zone Pointer to integer value specifying the zone number to attach to Pointer to integer value specifying the font 0 Helvetica 6 Times Italic 1 Helvetica Bold 7 Times Bold Font 2 Greek 8 Times Italic Bold 3 Math 9 Courier 4 User Defined 10 Courier Bold 5 Times Pointer to integer value specifying the font height units FontHeightUnits 0 Grid 2 Point 1 Frame FontHeisht Pointer to double value specifying the font height If PosCoordMode is set to 8 FRAME the value range is zero to
60. 0E 000 2 10E 000 6 30E 000 3 20E 000 3 OP OW UBNMN WN ND PRPNND NN WF Oo 192 Finite Element Data FE surface data Finite element surface data specify node locations in three dimensions Consider the data in Table 4 3 Locations are listed for eleven nodes each having only the three spatial variables X Y and Z We would like to create an finite element surface zone with this data set where some of the ele ments are triangles and some are quadrilaterals All the elements could be organized into one zone of element type Quadrilateral However as an illustration of creating 3D surface data create three zones one triangular one quadrilateral and one a mixture using quadrilaterals with repeated nodes for the triangles Table 4 3 Data set with eleven nodes and three variables x Y Z 0 0 0 0 1 0 0 0 0 0 2 0 1 0 0 0 2 0 1 0 1 0 0 0 1 0 1 0 1 0 1 0 1 0 0 0 1 0 1 0 1 0 1 0 1 0 0 0 1 0 1 0 1 0 1 0 1 0 0 0 1 0 1 0 1 0 A Tecplot 360 data file for the data in Table 4 3 is shown below in POINT format and plotted in Figure 4 15 TITLE Example 3D FE SURFACE ZONES VARIABLES x Y Z ZONE T TRIANGLES NODES 5 ELEMENTS 4 DATAPACKING POINT ZONETYPE FETRIANGLE 0 0 0 0 1 0 1 0 1 0 0 0 193 ASCII Data ZONE T PURE QUADS NODES 8 ELEMENTS 4 DATAPACKING POINT ZONETYPE FEQUADRILATERAL 1 0 1 0 0 0 1
61. 100 Pointer to integer value specifying the box type BoxType 0 None 2 Hollow 1 Filled BoxMargin Pointer to double value specifying the box margin in frame units ranging from 0 to 100 BoxLineThickness Pointer to double value specifying the box line thickness in frame units ranging ness from 0 to 100 49 TECUSR112 Parameter Description Pointer to integer value specifying the color to assign to the box 0 Black 8 Customl 1 Red 9 Custom2 2 Green 10 Custom3 BoxColor 3 Blue 11 Custom4 4 Cyan 12 Custom5 5 Yellow 13 Custom6 6 Purple 14 Custom7 7 White 15 Custom8 BoxFillColor Pointer to integer value specifying the fill color to assign to the box See Box Color Angle Pointer to double value specifying the text angle in degrees Pointer to integer value specifying where to anchor the text O Left 5 MidRight 1 Center 6 HeadLeft er 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 Pointer to integer value specifying the scope with respect to frames A local Se scope places the object in the current frame A global scope places the object in P all frames that contain the current frame s data set 0 Global 1 Local Specifies whether to clip the geometry that is only plot the geometry within to Clipping
62. 12 INTEGER4 Var char Name char Value Return Value 0 if successful 1 if unsuccessful 51 TECZAUXSTR112 Parameters Parameter Description Var The variable number for which to set the auxiliary data Variable numbers start at one The name of the auxiliary data item Ifa data item with this name already exists its Name value will be overwritten Must be a null terminated character string and cannot contain spaces The auxiliary data value to be written to the data file Must be a null terminated al d Value character string Example The following example illustrates adding auxiliary data to the pressure variable in the data file In this case pressure is the third variable INTEGER4 Var 3 char PressureUnitsName 16 PressureUnits char PressureUnitsValue 16 Pascal Pa TECVAUXSTR112 amp Var amp PressureUnitsName 0 amp PressureUnitsValue 0 TECZAUXSTR112 Writes an auxiliary data item for the current zone to the data file Must be called immediately after TECZNE112 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 Aux Data page of the Data Set Information dialog accessed via the Data menu The value can be verified by selecting Zone from the Show Auxiliary Data menu and selecting the corresponding zone number FORTRAN Syntax INTEGER 4 FUNC
63. 1345 80 90 100 110 120 Position Figure 4 6 A multi zone XY Line plot Pressure 179 ASCII Data All of the values for the first variable Position at each data point are listed first then all of the values for the second variable Temperature at each data point and so forth TITLE Example Multi Zone XY Line Plot VARIABLES Position Temperature Pressure ZONE DATAPACKING BLOCK T 0 0 seconds I 4 71 30 86 70 103 1 124 4 563 7 556 7 540 8 449 2 101362 5 101349 6 101345 4 101345 2 ZONE DATAPACKING BLOCK T 0 1 seconds I 4 71 31 84 42 103 1 124 8 564 9 553 1 540 5 458 5 101362 1 101348 9 101344 0 101342 2 TEXT CS FRAME HU POINT X 16 Y 90 H 28 T SAMPLE CASE Multi Zone XY Line Plot with Variable Sharing Example If the data from the section above was taken at the same position for both times variable sharing could reduce memory usage and file size That file appears as TITLE Example Multi Zone XY Line Plot with Variable Sharing VARIABLES Position Temperature Pressure ZONE T 0 0 seconds I 4 71 30 563 7 101362 5 86 70 556 7 101349 6 103 1 540 8 101345 4 124 4 449 2 101345 2 ZONE T 0 1 seconds I 4 VARSHARELIST 1 1 share variable 1 from zone 1 564 9 101362 1 553 1 101348 9 540 5 101344 0 458 5 101342 2 TEXT CS FRAME HU POINT X 16 Y 90 H 28 T SAMPLE VARIABLE SHARING CASE 180 Ordered Data Cell Centered Data An example of
64. 3 5 2 0 80 0 35 0 0 85 4 0 2 0 78 0 35 0 0 80 3 0 3 0 83 0 35 0 0 80 3 5 3 0 80 0 35 0 0 85 4 0 3 0 77 0 33 0 0 78 This data file has two zones and five variables and is included with Tecplot 360 as the file exam ples dat multzn2d dat The first zone has nine data points arranged in a three by three grid 123 J 3 Each row of each zone represents one data point where each column corresponds to the value of each variable for a given data point i e X 1 0 Y 2 0 Press 100 0 Temp 50 0 and Vel 1 0 for data point one in zone one Big Zone Similarly the second zone Small Zone has six data points in a three by two mesh I 3 J 2 Reading this data file yields the mesh plot shown in Figure 4 13 Refer to Section Two Dimensional Field Plots on page 190 for an presentation of the same data in finite element format Three Dimensional Field Plots IJK ordered data sets have the general form shown below TITLE Example Simple 3D Volume Data VARIABLES X Y Z Density ZONE I 3 J 4 K 3 DATAPACKING POINT 1 0 2 0 1 1 2 21 2 0 2 1 1 2 5 05 3 0 2 2 1 1 7 16 1 0 3 0 1 2 3 66 182 Finite Element Data The complete ASCH data file is included with Tecplot 360 as simp3dpt dat POINT format and in block format as simp3dbk dat When you read either of these files into Tecplot 360 the plot will appear as shown in Figure 4 8 LIK 77 ESA NY NL D WEIN EI SEI gt ZEKE SRN AN x
65. 4 183 parameters 173 syntax 159 Text Record 165 168 Zone Record 152 165 ASCII format syntax 149 Auxiliary Data 28 157 variable auxiliary data 51 173 zone auxiliary data 52 Axis Labels 43 B Binary Data byte order 36 conversion from ASCII 149 200 File Format 209 220 geometry creation 37 text record 47 user record 50 Binary files debugging 24 writing to multiple 26 35 writing to multiple example 138 Block Data 158 Boundary Connection 59 Boundary Face 59 Boundary Map 165 Brick cells 184 Byte order 36 C Cell centered 16 Cell centered Data 32 159 Cell centered data 16 Connected Boundary Face 59 Connectivity list 161 cell based finite elements 44 face based finite elements 45 sharing 156 165 Custom Label Record ASCII data 171 binary data 43 D Data cell centered 16 FE Volume 16 nodal 16 Data Arrangement 31 Data conversion 149 200 Data File Format ASCH 150 174 binary 209 220 Data structure finite element 13 ordered data 12 Data Types 158 E EOF 33 Examples ASCII auxiliary data 172 finite element 187 200 Geometry 170 ordered data 175 183 Text Record 168 Binary Face Neighbors 64 geometry record 148 IJ ordered 133 polygonal data 77 polyhedral zones 84 104 126 text record 145 F Face Neighbors 161 164 data 33 example 64 mode 162 polyhedral zones 62 right hand rule 62 scope 162 Face Numbering cell based finite elements 163 Facemap data 45 163 221 INDEX poly
66. For each face curl the fingers of your right hand following the order that the nodes were presented in the FaceNodes array Your thumb will point to the right element The left element is the other adjacent element Ifthe face has more than one neighboring element on a single side you will need to use the FaceBoundaryConnectionCounts FaceBoundaryConnectionElems and FaceBoundaryConnectionZones array The neighboring elements for each face are stored in the FaceRightElems and FaceLeftElems array Each array is dimensioned by the total number of faces in the zone The first value in each array is the right or left neighboring element for Face 1 followed by the neighboring element for Face 2 and so forth FaceRightElems RightNeighborToFacel RightNeighborToFace2 RightNeighborToFaceF FaceLeftElems LeftNeighborToFacel LeftNeighborToFace2 LeftNeighborToFaceF where F is the total number of faces 62 Defining Polyhedral and Polygonal Data In the above plot the face neighbors are as follows Face Number Right Neigh Left Neigh boring Ele boring Ele ment ment Face 1 1 0 Face 2 1 0 Face 3 1 2 Face 4 1 3 Face 5 1 4 Face 6 1 0 Face 7 2 0 Face 8 2 0 Face 9 2 0 Face 10 2 3 Face 11 3 0 Face 12 3 4 Face 13 4 0 Face 14 4 0 Face 15 4 0 The number zero is used to indicate that the face is on the edge of the data i e has no n
67. G END BOTH lt boxtype gt NOBOX HOLLOW FILLED lt clipping gt CLIPTOVIEWPORT CLIPTOFRAME lt color gt BLACK RED GREEN BLUE CYAN YELLOW PURPLE WHITE CUST1 CUST8 lt coordinatesys gt FRAME GRID GRID3D lt datapacking gt BLOCK POINT lt datatype gt SINGLE DOUBLE lt draworder gt AFTERDATA BEFOREDATA lt font gt HELV HELV BOLD TIMES TIMES ITALIC TIMES BOLD TIMES ITALIC BOLD COURIER COURIER BOLD GREEK MATH USER DEF lt geomtype gt LINE SQUARE RECTANGLE CIRCLE ELLIPSE lt heightunits gt In FRAME coordinatesys either FRAME or POINT in GRID coordinatesys either GRID or FRAME 173 ASCII Data lt linetype gt SOLID DASHED DASHDOT DOTTED LONGDASH DASHDOTDOT lt scope gt GLOBAL LOCAL lt textanchor gt LEFT CENTER RIGHT MIDLEFT MIDCENTER MIDRIGHT HEADLEFT HEADCENTER HEADRIGHT lt varlocation gt NODAL CELLCENTERED lt zone gt zone number to which this item is assigned 0 all lt zonetype gt ORDERED FELINESEG FETRIANGLE FEQUADRILATERAL FETETRAHEDRON FEBRICK FEPOLYGON or FEPOLYHEDRAL 4 4 Ordered Data For ordered data the numerical values in the zone data must be in either POINT or BLOCK format specified by the DATAPACKING parameter 4 4 1 I Ordered Data I ordered data has only one index the I index This type of data is typically used for XY plots scatter plots and irregular random data for triangulation or for interpolation into an IJ or
68. Multiple Polyhedral Zones ces Multiple Polygonal Zones ie Polyhedral Example di T ordered zone iii das lda ire ediles dad Switching between two files eeeneenenennennennennennenn Text Example su sans fear Geometry Example ia da Preplotiar aaa ero S 149 Syntax Rules amp Limits serseri iaaa 149 ASCII File Structure coooooocccncnononoconcnnnononcnonononononnonon nono canon cn nonnnnnns 150 A AA n tiie vsdvncnsddicthdueteleedentebtententes 151 EN A O 152 A A coh indeahsgsdna sadendcoeutentantinten selees 165 Geometry Record sauna 168 Custom Labels Record 171 Data Set Auxiliary Data Record ocio 172 Variable Auxiliary Data Record 173 ASCII Data File Parameter Assignment Values 173 Ordered Dita inicia ais 174 LOrdered Data sisi taa ica ori ansia ic ecu 174 Ordered Data iii iead dilo ide iia at 174 IK O rdered Diluvio dsc 175 Ordered Data Examples neenenenenenenennennensensnnnn 175 Finite Element Data ne nenn 183 Variable and Connectivity List Sharing 185 Finite Element Data Set Examples ce 187 ASCII Data File Conversion to Binary ueenseeseeensennennene 200 Preplot Options neeeeenennensensensensensensensennennn nennen nenne 201 Preplot Examples occiso nennen ana 201 Chapter 5 DOS SOI ee se 203 Appendix A Binary Data File Format 209 Table of Contents Chapter 1 Introduc
69. NTEGER4 INTEGER4 INTEGER4 INTEGER4 INTEGER4 INTEGER4 INTEGER4 INTEGER4 INTEGER4 INTEGER4 0 if successful 1 if unsuccessful JCellMax KCellMax SolutionTime StrandID ParentZone IsBlock NumFaceConnections FaceNeighborMode TotalNumFaceNodes NumConnectedBoundaryFaces TotalNumBoundaryConnections PassiveVarlist ValueLocation ShareVarFromZone ShareConnectivityFromZone Parameters Parameter Applies to Zone Type s Notes ZoneTitle ALL The title ofthe zone Must be null terminated The type of the zone O ORDERED 1 FELINESEG 2 FETRIANGLE ZoneType ALL 3 FEQUADRILATERAL 4 FETETRAHEDRON 5 FEBRICK 6 FEPOLYGON 7 FEPOLYHEDRON IMax For ordered zones the number of nodes in the I or ALL index direction For finite element zones cell based NumPts and face based the number of nodes JMax For ordered zones the number of nodes in the J or ALL index direction For finite element zones cell based NumElements and face based the number of elements KMax ORDEREDFEPOLY For ordered zones the number of nodes in the K l ok GON index direction For polyhedral and polygonal finite NumFaces FEPOLYHEDRON element zones it is the number of faces Not used all other finite element zone types ICellMax N A Reserved for future use Set to zero TECZNE112 Parameter Applies to Zone Type s Notes JCellMax N A Reserved for future u
70. OOOHLRHRH oWWUWPOOOOoOO0O000 gt o o The above finite element data file has eight nodes the first eight rows of the zone and four ele ments the last four rows of the zone Each row in the node matrix represents a given node Each column in the row matrix corresponds to the value of each variable at a given node The order of the variables definition correlates to the order the variables are named in the data set i e for node one X 0 0 Y 1 0 P 75 0 and T 1 6 The element matrix defines the connectivity of the nodes i e element one is composed of nodes one two five and four 190 Finite Element Data Please refer to Chapter 3 Data Structure in the User s Manual for information on ordered and FE data sets Triangle Data in BLOCK Format Example An example of triangle element type finite element data is listed below There are two variables x Y and five data points This data set is plotted in Figure 4 14 Each data point is labeled with its node number Figure 4 14 A finite element triangle data set In this example each column of the data section corresponds to a node and each row to a variable Each row of the connectivity list corresponds to a triangular element and each column specifies a node number VARIABLES X Y ZONE NODES 5 ELEMENTS 3 DATAPACKING BLOCK ZONETYPE FETRIANGLE 1 0 2 0 2 5 3 5 4 0 0 1 0 5 0 1 0 WU REA UNNOo A A WW FORTRAN Code This F
71. ORTRAN code creates triangle element type finite element data in BLOCK format INTEGER VAR WRITE ZONE DATAPACKING BLOCK ZONETYPE FETRIANGLE NODES NNODES 191 ASCII Data amp ELEMENTS NELEM DO 1 VAR 1 NUMVAR DO 1 NODES 1 NNODES WRITE VARRAY VAR NODES 1 CONTINUE DO 2 M 1 NELEM DO 2 L 1 3 WRITE NDCNCT M L 2 CONTINUE Finite Element Zone Node Variable Parameters Example The node variable parameter allows setting of the connectivity to match the value of the selected node variable In the example below the files appear to be identical in Tecplot 360 although the connectivity list has changed to reflect the values of the node order Notice that the index value of the nodes is not changed by the node variable value The original data set TITLE Data with original node ordering VARIABLES PA PE ZONE T Triangulation NODES 6 ELEMENTS 5 DATAPACKING POINT ZONETYPE FETRIANGLE DT SINGLE SINGLE 2 00E 000 3 00E 000 2 20E 000 3 10E 000 3 10E 000 4 20E 000 2 80E 000 3 50E 000 2 40E 000 2 10E 000 4 30E 000 3 20E 000 125 6 4 3 5 46 234 524 The data set with the nodes re ordered for connectivity TITLE Data with modified node ordering VARIABLES x Y Node Order ZONE T Triangulation NODES 6 NV 3 ELEMENTS 5 DATAPACKING POINT ZONETYPE FETRIANGLE DT SINGLE SINGLE 00E 000 3 00E 000 5 20E 000 3 10E 000 4 10E 000 4 20E 000 1 80E 000 3 50E 000 2 4
72. RAN Syntax INTEGER 4 FUNCTION TECEND112 C Syntax include TECIO h INTEGER4 TECEND112 Return Value 0 if successful 1 if unsuccessful Parameters None TECFACE112 Writes face connections for the current zone to the file Face Neighbor Connections are used for ordered or cell based finite element zones to specify connections that are not explicitly defined by the connectivity list or ordered zone structure You many use face neighbors to specify connections between zones global connections or connections within zones local connections Face neighbor connections are used by Tecplot when deriving variables or drawing contour lines Specifying face neighbors typically leads to smoother connections NOTE face neighbors have expensive perfor mance implications Use face neighbors only to manually specify connections that are not defined via the connectivity list This function must be called after TECNOD112 and may only be called if a non zero value of NumFaceConnections was used in the previous call to TECZNE112 FORTRAN Syntax INTEGER 4 FUNCTION TECFACE112 FaceConnections INTEGER 4 FACECONNECTIONS C Syntax include TECIO h INTEGER4 TECFACE112 INTEGER4 FaceConnections 33 TECFACE112 Return Value 0 if successful 1 if unsuccessful Parameters Parameter Description The array that specifies the face connections The array must hav
73. TION TECZAUXSTR112 Name Value CHARACTER Name CHARACTER Value C Syntax include TECIO h INTEGER4 TECZAUXSTR112 char Name char Value 52 TECZNE112 Return Value 0 if successful 1 if unsuccessful Parameters Parameter Description 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 and cannot contain spaces Value The auxiliary data value to be written to the data file Must be a null terminated character string Example The following example code adds auxiliary data to the zone NOTE TECZAUXSTR112 must be called immediately after TECZNE112 for the desired zone char CreatedByName 16 char CreatedByValue 16 CreatedBy My Company TECZAUXSTRI112 amp CreatedByName 0 amp CreatedByValue 0 TECZNE112 Writes header information about the next zone to be added to the data file After TECZNE112 is called you must call TECDAT112 one or more times If the zone is a finite element zone call TECNOD112 cell based zones or TECPOLY 112 face based zones after calling TECDAT112 ZoneType please note that some features in Tecplot 360 are limited by zone type For example iso surfaces and slices are avail able for 3D zones types only FETETRA HEDRON FEBRICK FEPOLYHEDRON and ORDERED with K greater than 1 However the plot type that you specify
74. acro file There are two types of macro variables user defined you set and retrieve the value or internal Tecplot sets the value and you may retrieve it In polyhedral polygonal fe data sets the term no neighboring ele No Neighboring Element ment refers to a face that does not have a neighboring element on either its right or left side Node A point in finite element data Number Format The style of numbers to display for a data or axis label exponent inte ger float and so forth Ordered Data A type of data point organization which consists of a parameterized series of points There are seven types of ordered data I J K IJ JK IK and IJK ordered I IJ and IJK ordered are the most com mon Polygonal A 2D face based finite element type The number of nodes per element is variable That is a single polygonal zone may contain triangular quadrilateral hexagonal etc elements Polyhedral A 3D face based finite element type The number of nodes per element is variable That is a single polyhedral zone may contain tetrahedral and brick and others elements Point A data file format for an I IJ or IJK ordered zone in which the data is listed by point All of the variable values for the first data point are listed first then all the variable values for the second data point and so forth Quadrilateral An element type of finite element surface data w
75. active zone layers which may include mesh contour vector shade scatter and edge 208 Appendix A Binary Data File Format Refer to this section only if you wish to write your own functions Otherwise refer to Section 3 1 Getting Started for instructions for linking with the library provided by Tecplot Inc BINARY FILE FORMAT The binary data file format as produced by the preplot is described below The binary datafile has two main sections A header section and a data section HEADER SECTION FLOAT32 EOHMARKER value 357 0 DATA SECTION I HEADER SECTION The header section contains the version number of the file a title of the file the names of the variables to be plotted the descriptions of all zones to be read in and all text and geometry definitions i Magic number Version number TDV112 8 Bytes exact characters TDV112 pan Version number follows the V and consumes the next 3 characters for example V75 V101 ii Integer value of 1 209 Binary Data File Format iii iv Title and variable INT32 INT32 N INT32 INT32 N Zones
76. alling TECZNE For sim plicity we are reusing many of the variables that were defined for Zone 1 5 118 Examples Q 119 TECZNE112 Step 8 Specify the variable values for Zone 2 The variable values are written to the data file via the TECDAT function For each variable you must provide either a total number of values equivalent to NumPts if the variables are nodal or equivalent to NumElements ifthe variables are cell centered The variable location is specified by the VarLocation parameter in TECZNE In this example X and Y are nodal variables and P is cell centered The order in which the variable values must be provided is established by the numbering scheme specified at the beginning of the example The first value for each nodal variable X and Y corre sponds to Node 1 the second value corresponds to Node 2 and so forth The first value for the cell centered value is for Element 1 the second value is for the second element or cell and so forth In order for the example to be easily followed the grid coordinates are explicitly defined When working with larger data sets you will likely wish to use equations to define your coordinates Refer to the picture in Step 7 for the X and Y coordinate values for Zone 2 120 Examples TECZNE112 Step 9 Specify the face map for Zone 2 Use the picture in Step 7 to specify which nodes compose which face The first two values in the face no
77. are stored when accessing data 16 Face Neighbors You can determine the value location by calling TecUtilDataValueGetLocation Example 2 4 Face Neighbors A cell is considered a neighbor if one of its faces shares all nodes in common with the selected cell or if it is identified as a neighbor by face neighbor data in the dataset The face numbers for cells in the various zone types are defined below Figure 2 1 A Example of node and face neighbors for an FE brick cell or IJK ordered cell B Example of node and face numbering for an IJ ordered FE quadrilateral cell C Example of tetrahedron face neighbors The implicit connections between elements in a zone may be overridden or connections between cells in adjacent zones established by specifying face neighbor criteria in the data file Refer to Section TECFACE112 on page 33 of the Data Format Guide for additional information 17 Data Structure 2 5 Working with Unorganized Datasets Unorganized datasets are loaded as a single I ordered zone and will be displayed in XY Mode by default An I ordered zone is irregular if it is known to have more than one dependent variable An I ordered dataset with one dependent variable i e an XY or polar line is NOT an irregular zone To check for irregular data you can go to the Data gt Dataset Info dialog accessed via the Data menu The values assigned to IMax JMax and KMax are displayed in th
78. brary included with this dis tribution your plt file will be compatible with this version of Tecplot and newer 3 6 1 UNIX Linux Macintosh NOTE Some f90 compilers do not accept the f90 file extension You may need to rename the files and edit the Make script to build these examples 1 Verify that tecio a is located in the lib directory below the Tecplot home directory 2 Set your STEC_360_2008 environment variable to the Tecplot home directory 3 Run Make Capital M 3 6 2 Windows NOTE Only the c and f90 source files are used on Windows operating systems To link with the Tec1o library perform the following steps 1 Create a development project 2 List TEC_360_2008 bin tecio lib as an additional dependency In Visual Studio 2005 this is accomplished via Configuration Properties gt Linker gt Input in the Project Properties dialog 3 Include the TecIo header files TECIO h and TECXXX h located in STEC_360_2008 Include 1 On Windows platforms you will need to include tecio dll in any distributions you create Tecio dll is provided in STEC_360_2008 bin along with tecio lib 27 TECAUXSTR112 3 6 3 Notes for Windows Programmers using Fortran The included project files were developed and tested with Compaq Visual Fortran version 6 6 File tecio f90 contains both Fortran 90 interfaces for all TecIo functions and some compiler specific directives the MS ATTRIBUTES lines to direct Visual Fortra
79. can group your elements to fit complex boundaries and 13 Data Structure leave voids within sets of elements The figure below shows how finite element data can be used to model a complex boundary Figure 2 1 This figure shows finite element data used to model a complex boundary This plot file feexchng plt is located in your Tecplot 360 distribution under the examples 2D subdirectory Finite element data defines a set of points nodes and the connected elements of these points The variables may be defined either at the nodes or at the cell element center Finite element data can be divided into three types Line data is a set of line segments defining a 2D or 3D line Unlike I ordered data a single finite element line zone may consist of multiple disconnected sections The values of the variables at each data point node are entered in the data file similarly to I ordered data where the nodes are numbered with the I index This data is followed by another set of data defining connections between nodes This second section is often referred to as the connectivity list All elements are lines consisting of two nodes specified in the connectivity list Surface data is a set of triangular quadrilateral or polygonal elements defining a 2D field or a 3D surface When using polygonal elements the number of sides may vary from element to element In finite element surface data you can choose by zone to arrange your
80. center 8 headright Zone 0 all Color MacroFunctionCommand string N Length 1 Clipping 0 ClipToAxes 1 ClipToViewport 2 ClipToFrame Text N Text Length 1 CustomLabel Marker F 599 Number of labels Text for label 1 N length of label 1 215 Binary Data File Format II See note 1 Text for label 2 N length of label 1 See note 1 Text for label NumLabels N length of label 1 See note 1 UserRec Marker F 699 Text for UserRec See note 1 ix Dataset Auxiliary data DataSetAux Marker F 799 0 Text for Auxiliary Name See note 1 Auxiliary Value Format Currently only allow 0 AuxDataType_ String Text for Auxiliary Value See note 1 VarAux Marker F 899 0 Variable number zero based value Text for Auxiliary Name See note 1 Auxiliary Value Format Currently only allow 0 AuxDataType String Text for Auxiliary Value See note 1 DATA SECTION don t forget to separate the header from the data with an EOHMARKER The data section contains all of the data associated with the zone definitions in the header i For both ordered and fe zones FLOAT32 Zone marker Value 299 0 216 ii iii INT32 N Variable data format N Total number of vars Fs 2 S 1 Float 2 Double 3 LongInt 4 ShortInt 5 Byte 6 Bit INT32 Has passive variables 0 no 1 yes if
81. ction for each boundary face in Zone 2 is Element 1 in Zone 1 e NumConnectedBoundaryFaces 2 TotalNumBndryConnections 2 3 8 2 FaceNodeCounts and FaceNodes For illustration purposes consider a zone composed of a single pyramidal element The pyramid is composed of five nodes and five faces Figure 3 2 A simple pyramid The remaining triangular faces are Faces 2 and 3 The bottom rectangular face is Face 5 Node 4 is obscured from view The FaceNodeCounts array is used to specify the number of nodes that compose each face The values in the array are arranged as follows FaceNodeCounts NumNodesInFacel NumNodesInFace2 NumNodesInFaceF where F is the total number of faces in the zone In this example the FaceNodeCounts array is 3 3 3 3 4 The first four faces are composed of three nodes and the last face is composed of four nodes 60 Defining Polyhedral and Polygonal Data The FaceNodes array is used to specify which nodes belong to which face The array is dimen sioned by the total number of face nodes in the zone specified via TECZNE112 The total number of face nodes is defined as F gt NumNodesInFace f 1 The first K values in the FaceNodes array are the node numbers for Face 1 where K is the first value in the FaceNodeCounts array The next L values are the node numbers for Face 2 where L is the second value in the FaceNodeCounts array When supplying the node numbers for eac
82. d trademarks or trademarks of Dassault Syst mes in the U S and or other countries The Abaqus runtime libraries are a product of Dassault Syst mes Simulia Corp Provi dence RI USA FLOW 3D is a registered trademark or trademark of Flow Science Incorporated in the U S and or other countries Adobe Flash Flash Player Premier and PostScript are registered trademarks or trademarks of Adobe Systems Incor porated in the U S and or other countries AutoCAD and DXF are registered trademarks or trademarks of Autodesk Incorporated in the U S and or other countries Ubuntu is a registered trademark or trademark of Canonical Limited in the U S and or other countries HP LaserJet and PaintJet are registered trademarks or trademarks of Hewlett Packard Development Company Limited Partnership in the U S and or other countries IBM RS 6000 and AIX are registered trademarks or trademarks of International Business Machines Corporation in the U S and or other countries Helvetica Font Family and Times Font Family are registered trademarks or trademarks of Linotype GmbH in the U S and or other countries Linux is a registered trade mark or trademark of Linus Torvalds in the U S and or other countries ActiveX Excel Microsoft Visual C Visual Studio Windows Windows Metafile Windows XP Windows Vista Windows 2000 and PowerPoint are registered trademarks or trademarks of Microsoft Corporation in the U S and or other countries Firefox is a registered tradema
83. de array define Face 1 the next two define Face 2 and so on 122 Examples Step 10 Specify the neighboring elements for Zone 2 Now that we have defined the nodes that compose each face we must specify the element on either side of each face The neighboring elements can be determined using the right hand rule For each face place your right hand along the face with your fingers pointing the direction of incrementing node numbers i e from Node 1 to Node 2 The right side of your hand bajo ticas the A a ment and the La A of ol hand will indicate the left element Refer to tElems and FaceLeftElems for details The number zero is used to indicate that there isn t an element on that side of the face A negative number is used when the neighboring element is in another zone The value of the negative number points to the position in the FaceBoundaryConnectionElems and FaceBoundaryConnectionZones arrays that defines the element and zone numbers of the neighboring element Refer to Step 11 for details Because of the way we numbered the nodes and faces the right element for every face is the element itself The left element will either be another element in the zone no neighboring ele 123 TECZNE112 ment or an element in Zone 2 The term no neighboring element is used to describe a face that is on the edge of the entire data set not just the zone 124 Examples Step 11 Specify t
84. e For nodal data the number of stored values is equal to IMAX JMAX KMAX For cell centered IJ ordered data where IMAX and JMAX are greater than one and KMAX is equal to one the number of stored values is IMAX 1 JMAX 1 similarly for un JK ordered and IK ordered data Cell Centered Values are Stored Here 12 Finite Element Data Three dimensional Ordered Data IJK ordered A three dimensional array where all IMAX ae JMAX and KMAX are each greater than one AS For nodal ordered data the number of nodes is f the product of the I J and K dimensions For pls nodal data the number of stored values is equal to IMAX JMAX KMAX For cell centered data the number of stored values is IMAX 1 IMAX 1 KMAX 1 A Cell Centered Value Are Stored Here 2 2 Finite Element Data While finite element data is usually associated with numerical analysis for modeling complex prob lems in 3D structures heat transfer fluid dynamics and electromagnetics it also provides an effective approach for organizing data points in or around complex geometrical shapes For exam ple you may not have the same number of data points on different lines there may be holes in the middle of the dataset or the data points may be irregularly randomly positioned For such diffi cult cases you may be able to organize your data as a patchwork of elements Each element can be independent of the other elements so you
85. e Set any other kriging param eters as desired see Section 20 10 3 Kriging for details Select the Compute button to perform the kriging Once the interpolation is complete you can plot the new IJK ordered zone as any other 3D volume zone You may plot iso surfaces volume streamtraces and so forth At this point you may want to deactivate or delete the original irregular zone so as not to conflict with plots of the new zone Figure 2 3 shows an example of irregular data interpolated into an IJK ordered zone with iso sur faces plotted on the resultant zone Irregular 3D Volume Data Interpolated IJK Ordered Data A IN i A AN Figure 2 3 Irregular data interpolated into an IJK ordered zone 20 Time and Date Representation 2 6 Time and Date Representation Tecplot 360 uses floating point numbers to represent times and dates The integer portion represents the number of days since December 30 1899 The decimal portion represents a fractional portion of a day The table below illustrates some examples of this method Date Time Floating Point Number 1900 01 01 00 00 00 2 0 1900 01 01 12 00 00 2 5 2008 07 31 00 00 00 39660 0 2008 07 31 12 00 00 39660 5 2008 07 31 12 01 00 39660 5006944444 2008 07 31 13 00 00 39660 5416666667 Tecplot 360 supports dates from 1800 01 01 through 9999 12 31 This formatting matches the representation method used by Microsoft Excel enabli
86. e boundaries Facemap Data For face based finite element zones FEPOLYGON and FEPOLYHEDRAL the data section is followed by the Facemap Data section If boundary faces are used the Facemap Data section is fol lowed by the Boundary Map Data data section Otherwise the facemap data section marks the end of the zone record 163 ASCII Data The face map data in four major groupings is defined by the following list Like the Data section of the zone record the data region of the Face Map section does not include tokens It includes a list of data The descriptors TotalNodesInFace WhichNodesInFace Left NeighborForFace and RightNeighborForFace should not be included in your data file 1 TotalNodesInFace A space separated list of the total number of nodes in each face NodesInFace NodesInFace NodesInFace where F is equal to the total number of faces NOTE The TotalNodesInFace section is not used for polygonal zones as each face of a polygon always has two nodes 2 WhichNodesInFace A list of the node numbers for each node in each face Use a separate line for each face Face Node Face Node Face NodeTotalNodesInFacel Face Node Face Node Face NodeTotalNodesInFace FacepNode Face Node Face NodetotalNodesInFaceF 3 LeftNeighborForFace A list of left neighboring elements for each face LeftElementForFace LeftElementForFace LeftElementForFace p 4 RightNeighborForFace A
87. e L values where L is the sum of the number of values for each face neighbor connection in the data file FaceConnec l ee ti The number of values in a face neighbor connection is dependent upon the Face ms NeighborMode parameter set via TECZNE112 and is described in the following table FaceNeighbor Mode Number of Data values LocalOneToOne 3 czl fz cz2 LocalOneToMany nz 4 cz1 fz 0Z nZ CZ2 CZ3 CZM GlobalOneToOne 4 cz fz ZZ CZ GlobalOneToMany 2 nz 4 ez fz oz nz ZZ1 CZ1 ZZ2 CZ2 ZZn CZn 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 360 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 360 s auto face neighbor generator FE only 34 TECFIL112 The face numbers for cells in the various zone types are defined in Figure 3 1 n 3 n3 f4 f2 n1 fl n2 B C Figure 3 1 A Example of node and face neighbors for an fe brick cell or IJK ordered cell B Exam
88. e lower left quadrant of that dialog If IMax is greater than 1 and JMax and KMax are equal to 1 then your data is irregular It is also easy to tell if you have irregular data by looking at the plot If you are looking at irregular data with the Mesh layer turned on the datapoints will be connected by lines in the order the points appear in the dataset There are several ways to organize your dataset 1 Manually order the data file using a text editor Use the Label Points and Cells feature from the Plot menu to see if your dataset can be easily cor rected using a text editor by correcting the values for I J and or K 2 Use the Data gt Triangulate feature 2D only See Section 20 11 Irregular Data Point Triangulation 3 Use one of the Data gt Interpolation options See Section 20 10 Data Interpolation 4 If you have multiple zones of irregular data that you would like to combine into one finite element zone use the Create Zone gt Create Zone From Polylines from the Data menu Refer to Section 20 6 6 FE Surface Zone Creation from Polylines for more information 5 Special Cases use when interpolation results appear skewed e Well data If points are closely positioned along the depth axis and far apart in physical space use the Tetra Grid add on to create a new zone with all points connected into 3D zones See Section 32 3 17 Tetra Grid Fluid Measurements Wh
89. e many of the variables from that are not relevant to this tutorial Zone 2 the arrowhead or prism has a single element composed of six nodes and five faces 96 Examples Step 8 Specify the variable values for Zone 2 Now that the zone has been created we must write the variable values to the file by calling TECDAT While there are more elegant ways to define the grid coordinates for the prism the values are defined explicitly in order to keep the example relatively simple 97 TECZNE112 Using the picture below define the variable values 98 Examples 99 TECZNE112 Step 9 Define the face map for the arrowhead Before creating the data set we have defined the node numbers face numbers and element num bers Using the following figure specify the nodes that define each face Figure 3 4 The arrowhead with three faces visible Face 2 Face 3 and Face 5 The remaining rectangular face is Face 1 and the remaining triangular face is Face 4 The faces are created from the data file format using the FaceNodeCounts and FaceNodes array The FaceNodeCounts array specifies the number of nodes contained in each face The first value in the array is the number of nodes in Face 1 followed by the number of nodes in Face 2 and so forth The FaceNodes array lists the node numbers in each face The FaceNodes array first lists all of the nodes in Face 1 followed by all of the nod
90. e square For RECTANGLE the geometry data consists of two numbers the first is the width horizontal axis dimension and the second is the height vertical axis dimension For CIRCLE the geometry data is one number the radius For ELLIPSE the geometry data consists of two numbers the first is the horizontal axis length and the second is the vertical axis length For both circles and ellipses you can use the EP numellipsepts parameter to specify the number of points used to draw circles and ellipses All computer generated curves are simply collections of very short line segments the EP parameter allows you to control how many line segments Tecplot 360 uses to approximate circles and ellipses The default is 72 For LINE and LINE3D geometries the geometry data is controlled by the F format parameter These geometries may be specified in either POINT or BLOCK format By default POINT format is assumed Each geometry is specified by the total number of polylines up to a maximum of 50 polylines where each polyline can have up to 32 000 points Each polyline is defined by a number of points and a series of XY or XYZ coordinate points between which the line segments are drawn In POINT format the XY or XYZ coordinates are given together for each point In BLOCK format all the X values are listed then all the Y values and for LINE3D geometries all the Z values All coordinates are relative to the x Y and z specified on the control l
91. e the grid coordinates for the rectangle the values are defined explicitly for simplicity Using the picture below define the variable values 88 Examples For nodal variables provide the values for each variable in nodal order Similarly for cell centered values provide the variable values in cell order The location of each variable is specified with TECZNE 89 TECZNE112 Step 4 Define the facemap data for Zone 1 Using the following figure specify which nodes define which face Figure 3 3 Zone 2 of the sample data Node 7 is obscured from view and located in the back left hand corner Face 6 is the bottom face Face 3 is opposite Face 1 and Face 4 is opposite Face 2 In order to specify the face map data you must first specify how many nodes are in each face using the FaceNodeCounts array After defining the FaceNodeCounts array use the FaceNodes array to identify the nodes that compose each face Refer to Section 3 8 2 FaceNodeCounts and FaceNo des for additional information 90 Examples TECZNE112 When providing the node numbers for each face you must provide the node numbers in a consistent order either clockwise or counter clockwise Providing the node numbers out of order results in contorted faces 92 Examples Step 5 Specify the neighboring elements for Zone 1 The next step for writing out the polyhedral data is to define the
92. e 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 ALL NOTE Connectivity and or face neighbors cannot be shared when the face neighbor mode is set to Global Connectivity cannot be shared between cell based and face based finite element zones ShareConnectivity FromZone a Cell based finite element zones FELINESEG FETRIANGLE FEQUADRILATERAL FETETRAHEDRON and FEBRICK b Face based finite element zones FEPOLYGON and FEPOLYHEDRON Examples Refer to the following examples for illustrations of working with TECZNE112 e Section 2 4 Face Neighbors e Section 3 5 Writing to Multiple Binary Data Files e Section 3 9 2 Polygonal Example e Section 3 9 3 Multiple Polyhedral Zones e Section 3 9 4 Multiple Polygonal Zones e Section 3 9 5 Polyhedral Example 58 Defining Polyhedral and Polygonal Data 3 8 Defining Polyhedral and Polygonal Data Polyhedral data is defined using both TECPOLY112 and TECZNE112 Via TECZNE112 the number of nodes faces elements boundary faces and boundary connections are specified TECPOLY112 is used to specify the face mapping connections for the zone Before defining your polyhedral or polygonal data you should determine the numbering scheme for the nodes faces and elements in each zone of your data set The numbering scheme is comm
93. each element This is the connectivity list dimen sioned T M 7 moving fastest where M is the number of elements in the zone and NData Tis set according to the following list 2 Line Segment 4 Tetrahedral 3 Triangle 8 Brick 4 Quadrilateral Examples Refer to Section 3 9 1 Face Neighbors for examples using TECNOD112 TECPOLY112 Writes the face map for polygonal and polyhedral zones to the data file All numbering schemes are one based The first node is Node 1 the first face is Face 1 and so forth Refer to Section 3 8 Defining Polyhedral and Polygonal Data on page 59 for additional information Avoid creating concave objects or bad meshes as they will not look good when plotted FORTRAN syntax INTEGER 4 FUNCTION TECPOLY112 amp FaceNodeCounts amp FaceNodes amp FaceLeftElems amp FaceRightElems amp FaceBndryConnectionCounts amp FaceBndryConnectionElems amp FaceBndryConnectionZones INTEGER 4 FaceNodeCounts INTEGER 4 FaceNodes INTEGER 4 FaceLeftElems INTEGER 4 FaceRightElems INTEGER 4 FaceBndryConnectionCounts INTEGER 4 FaceBndryConnectionElems INTEGER 2 FaceBndryConnectionZones C Syntax include TECIO h INTEGER4 TECPOLY112 INTEGER4 FaceNodeCounts INTEGER4 FaceNodes INTEGER4 FaceLeftElems INTEGER4 FaceRightElems TECPOLY112 INTEGER4 FaceBndryConnectionCounts INTEGER4 FaceBndryConnectionElems INTEGER4 FaceBndryConnecti
94. ecplot add on which allows you to read non Tecplot data files Data Point An XYZ point at which field variables are defined 204 Data Set A set of one or more zones A data set may be plotted in one or more frames However a single frame may only plot one data set A data set may be created by loading one or more data files Element Type The form of individual elements in a finite element zone There are four types of cell based finite element zones Triangle and Quadrilateral finite element surface types and Tetrahedron and Brick finite ele ment volume types For cell based finite elements the element type of a zone determines the number of nodes per element and their orienta tion within an element There are two types of face based finite element zones polygonal 2D and polyhedral 3D For face based elements the number of nodes per element is variable FE An abbreviation for finite element a common means of arranging data for calculations Often referred to as unordered or unstructured FE Surface A finite element zone of the element type Triangle Quadrilateral Poly gon These zones are used for 2D and 3D surface plots FE Volume A finite element zone of the element type Tetrahedron Brick Polyhe dron These zones are used for 3D volume plots Field Map A collection of zones for 2D and 3D field plots A common style can be easily applied to a
95. eighboring element 3 8 4 FaceBoundaryConnectionElements and Zones When working with multiple zones an additional aspect is folded into the FaceLeftElems and Fac eRightElems arrays When the neighboring element is not within the current zone you cannot iden tify the element by its element number alone Instead you need to specify both the element number and its zone number This is accomplished using the FaceBoundaryConnectionElements and Face BoundaryConnectionZones arrays For each boundary connection the element number of the boundary connection is stored in the FaceBoundaryConnectionElements array while its zone number is stored in the FaceBoundaryConnectionZones array 63 TECZNE112 A negative value in the FaceLeftElems or FaceRightElems array is used to indicate that the neigh boring element belongs to another zone The magnitude of the negative number is a pointer to a value in the FaceBoundaryConnectionElements and FaceBoundaryComnectionZones arrays For example given the following FaceBoundaryConnectionElements and FaceBoundaryConnec tionZones arrays FaceBoundaryConnectionElements FaceBoundaryConnectionZones A value of 4 in the FaceLeftElems indicates that the left neighboring element for that face is element four in zone three 3 8 5 Partially Obscured Boundary Faces A face on the boundary of a zone may be partially obscured by its boundary connections neighbor ing elements While Tecplot 360 does
96. en measurements are taken of fluid properties or con tainments and interpolating to a rectangular zone does not yield good results use the Prism Grid add on to create a 3D volume zone See Section 32 3 12 Prism Grid 2 5 1 Example Triangulate a Dataset One common source of finite element surface data is the triangulation option If you have 2D data without a mesh structure it is probably simplest to enter your data points as an I ordered dataset 18 Working with Unorganized Datasets then use the triangulation feature to create a finite element dataset You can then edit the file par ticularly the connectivity list to obtain the set of elements you want rather than having to create the entire connectivity list by hand We can triangulate a dataset as follows 1 Create a simple ordered data file as follows VARIABLES x Y PD TI 0 0 1 0 100 0 1 6 1 0 1 0 150 0 1 5 3 0 1 0 300 0 2 0 0 0 0 0 50 0 1 0 1 0 0 0 100 0 1 4 3 0 0 0 200 0 2 2 4 0 0 0 400 0 3 0 2 0 2 0 280 0 1 9 2 Save the file with extension dat 3 Load the data file and switch the plot type to 2D Cartesian 4 From the Data menu choose Triangulate 5 Select the simple ordered zone as the source zone and select Compute Irregular Data Point Triangulation Figure 2 2 shows a plot of the resulting data With triangulation we obtain more elements seven than when we created the dataset by hand four
97. eometry 41 222 Parameters P Parameters ASCII data file 173 Pltview 24 Polygonal zones 184 Polyhedral cells 184 Polyhedral data boundary connection 59 boundary face 59 Examples binary multiple zones 2D 104 multiple zones 3D 84 polygon 77 polyhedral 126 face neighbors 62 facemap data 60 Preplot 149 200 Q Quadrilateral cells 184 R Right hand rule face neighbors 62 S Scatter Plots 174 Shared grid 43 Solution file 43 Syntax ASCII format 149 TecIO functions 28 58 T TECAUXSTR112 28 TECDAT112 29 TECEND112 33 TECFACE 33 TECFIL 35 TECFOREIGN 36 TECGEO 37 TecIO functions 28 58 TecIO library 23 deprecated functions 25 function calling sequence 26 function reference 28 58 linking with 26 TECLAB 43 TECNOD 44 TECPOLY 45 TECTXT 47 TECUSR 50 TECVAUXSTR 51 TECZAUXSTR 52 TECZNE 53 Tetrahedral cells 184 Text Anchor 167 Text Record ASCII data 165 168 Binary Data 47 example 145 Text Anchor positions 167 Tick mark Labels 43 Triangular Cells 183 Triangulation 174 U Unstructured Data 174 User record binary data 50 Vv Variable auxiliary data 51 Variable Location 156 158 159 Variable location 16 Variable Sharing 156 160 185 Variables location 16 ViewBinary 24 X XY Plot example 179 XY Plots 174 Z Zone auxiliary data 52 Zone Footer 160 Zone header 53 Zone Record 152 165 Zone Type finite element zones 183 Zone Types 154 174 FEBRICK 184 FELINESEG 183
98. er the standard set of Preplot options or from a special set of options for reading PLOT3D format files If outfile is not specified the binary data file has the same base name as the infile with a p1t extension You may use a minus sign in place of either the infile or outfile to specify standard input or standard output respectively Any or all of iset jset and kset can be set for each zone but only one of each per zone For more Preplot command lines see Section B 4 Preplot in the User s Manual 4 6 2 Preplot Examples If you have an ASCII file named dset dat you can create a binary data file called dset p1t with the following Preplot command preplot dset dat dset plt By default Preplot looks for files with the dat extension and creates binary files with the plt extension Thus either of the following commands is equivalent to the above command preplot dset preplot dset dat Preplot checks the input ASCII data file for errors such as illegal format numbers too small or too large the wrong number of values in a data block and illegal finite element node numbers If Preplot finds an error it issues a message displaying the line and column where the error was first noticed This is only an indication of where the error was detected the actual error may be in the preceding columns or lines If Preplot encounters an error you may want to set the debug option to get more information about the events
99. es array Step 6 Define the right and left elements of each face The last step for writing out the polygonal data is to define the right and left neighboring elements for each face The neighboring elements can be determined using the right hand rule For each face place your right hand along the face with your fingers pointing the direction of incrementing node numbers i e from Node 1 to Node 2 The right side of your hand will indicate the right element and the left side of your hand will indicate the left element Refer to Section 3 8 3 FaceRight Elems and FaceLeftElems for details 83 TECZNE112 The number zero is used to indicate that there isn t an element on that side of the face i e the face is on the edge of the data set This is referred to as no neighboring element Because of the way we numbered the nodes and faces the right element for every face is the element itself Element 1 and the left element is no neighboring element Element 0 Step 7 Close the file Call TECEND to close the file 3 9 3 Multiple Polyhedral Zones The following example demonstrates how to create two polyhedral zones a rectangular solid and a prism The resulting image is a three dimensional arrow shown below This example covers the following topics polyhedral data working with multiple zones and spec ifying partially obscured faces In order to keep the example as simple as possible error checkin
100. es in Face 2 and so forth In this example Face 1 is composed of four nodes Node 1 Node 3 Node 6 and Node 4 As such the first value in the FaceNodeCounts array is 4 and the first four values in the FaceNodes array are 1 3 6 4 100 Examples TECZNE112 Step 10 Specify the neighboring elements for Zone 2 Now that we have defined the nodes that compose each face we must specify the element on either side of each face The neighboring elements can be determined using the right hand rule For each face place your right hand along the face with your fingers pointing the direction of incrementing node numbers i e from Node 1 to Node 2 The right side of your hand will indicate the n a ment and the En side of hte hand will indicate the left element Refer to eL for details The number zero is used to indicate that there isn t an element on that side ofthe face A negative number is used when the neighboring element is in another zone The value of the negative number points to the position in the FaceBoundaryConnectionElems and FaceBoundaryConnectionZones arrays that defines the element and zone numbers of the neighboring element Refer to Step 11 for details Because of the way we numbered the nodes and faces the right element for every face except the face connected to the rectangular solid is the element itself Element 1 and the left element is no neighboring element Element 0 102
101. face The neighboring elements can be determined using the right hand rule For each face place your right hand along the face with your fingers pointing the direction of incrementing node numbers i e from Node 1 to Node 2 The right side of your hand will nes the d ment and the e side of u hand will indicate the left element Refer to Secti htElems and FaceLeftElems for details The number zero is used to indicate that there isn t an element on that side ofthe face A negative number is used when the neighboring element is in another zone The value of the negative number points to the position in the FaceBoundaryConnectionElems and FaceBoundaryConnectionZones arrays that defines the element and zone numbers of the neighboring element Refer to Step 6 for details Because of the way we numbered the nodes and faces the right element for every face is the element itself The left element will either be another element in the zone no neighboring ele ment or an element in Zone 2 The term no neighboring element is used to describe a face that is on the edge of the entire data set not just the zone 115 TECZNE112 Step 6 Specify the boundary connections for Zone 1 The final step for creating Zone 1 is to define the boundary connections and call TECPOLY 116 Examples Q 117 TECZNE112 Step 7 Create Zone 2 Now that Zone 1 is complete we are ready to begin creating Zone 2 by c
102. g in three dimensions Three dimensional plotting can be subdi vided into 3D surface and 3D volume 3D Cartesian Plot A plot displaying a 3D scattering of points surfaces or volumes using three orthogonal axes 3D Surface Three dimensional plotting confined to a surface For example the surface of a wing 3D Volume Three dimensional plotting of data that includes interior data points of a volume as well as those on the surface For example the vector field around a wing Active Zone A zone that is displayed in the current plot as determined in the Zone Style dialog ASCH Data File A data file composed of human readable statements and numbers using ASCII characters Auxiliary Data Metadata attached to zones data sets and frames Binary Data File A data file composed of machine readable data This type of file is cre ated by converting ASCII data files with Preplot or by directly creating them from an application 203 Glossary Block A data file format in which the data is listed by variable All the point values of the first variable are listed first then all the point values of the second variable and so forth Boundary Cell Faces A set of un blanked cell faces in a 3D volume zone which have only one neighboring volume cell In contrast interior cell faces have two neighboring volume cells one on either side which share the face For an IJK
103. g is not included If you plan to compile this example be sure to include TECIO h and malloc h The source files for this example are included in your Tecplot 360 installation under the util tecio poly hedral arrow subdirectory 1 You may notice that malloc is used throughout the example This is done to clearly indicate the dimensions required for each array It is not required in practice 84 Examples For Sn a on me paramers used the function syntax for each TecIO function refer to When creating a nn data file dea te TeclO library th the functions must be called ina specific order Refer to ary C for details Step 1 Initialize the data file using TECINI TECINI is required for all data files This function opens the data file and initializes the file header information names the data file the variables for the data file and the file type 85 TECZNE112 Step 2 Create Zone 1 rectangle After TECINI is called call TECZNE to create one or more zones for your data file In this exam ple Zone 1 contains a single rectangular solid created as a face based finite element i e polyhedral zone The zone has eight points or nodes six faces and one element 86 Examples TECZNE112 Step 3 Set variable values for Zone 1 rectangle Now that the zone has been created write the variable values to the file by calling TECDAT While there are more elegant ways to defin
104. gned to an object via the Tecplot interface Refer to Section 17 7 1 Creating Custom Labels in the User s Manual for details FORTRAN Syntax INTEGER 4 FUNCTION TECLAB112 Labels CHARACTER Labels 43 TECNOD112 C Syntax include TECIO h INTEGER4 TECLAB112 char Labels Return Value 0 if successful 1 if unsuccessful Parameters Parameter Description Character string of custom labels Each label must be surrounded by double quotes Sepa Labels rate labels by a comma or space You may have up to sixty labels in each call to TECLAB112 Examples To add the days of the week to your data file to be displayed along the x axis char Labels 60 Mon Tues Wed Thurs Fri TECLAB112 amp Labels 0 TECNOD112 Writes an array of node data to the binary data file This is the connectivity list for cell based finite element zones line segment triangle quadrilateral brick and tetrahedral zones The connectivity list for face based finite element zones polygonal and polyhedral is specified via TECPOLY112 FORTRAN Syntax INTEGER 4 FUNCTION TECNOD112 NData INTEGER 4 NData T M C Syntax include TECIO h INTEGER4 TECNOD112 INTEGER4 NData Return Value 0 if successful 1 if unsuccessful 44 TECPOLY112 Parameters Parameter Description Array of integers listing the nodes for
105. h face you must supply the numbers in either a clockwise or counter clock wise configuration around the face Otherwise the faces will be contorted when the data is plotted It is not important to be consistent when choosing between clockwise or counter clockwise ordering The key is to present the numbers consistently within the numbering scheme For example you may present the node numbers for face 1 in a clockwise order and the node numbers for the remaining faces in counter clockwise order Consider the pyramid used above Using the FaceNodeCounts array we have already defined and the figure we can create the FaceNodes array for the pyramid FaceNodes 1 3 HAW urnmnmN ANARA 61 TECZNE112 3 8 3 FaceRightElems and FaceLeftElems After specifying the face map data using the FaceNodeCounts and FaceNodes array the next step is to identify the element on either side of each face To illustrate this we will switch from the single element zone to the following data set The neighboring elements can be determined using the right hand rule 2D Data For each face place your right hand along the face with your fingers pointing in the direction of incrementing node numbers i e from Node 1 to Node 2 The right side of your hand will indicate the right element and the left side of your hand will indicate the left element 3D Data
106. h no solution variables TITLE Example Grid File FILETYPE GRID VARIABLES X Y ZONE lI 3 J 3 K 1 ZONETYPE Ordered DATAPACKING BLOCK 0 0 0 5 1 0 0 0 0 5 1 0 0 0 0 0 0 0 0 5 0 5 0 5 ho oo ho ou he oo Example Solution File The following example displays a very simple solution file to be used with the Example Grid File TITLE Example Solution File FILETYPE SOLUTION VARIABLES Pressure ZONE I 3 J 3 K 1 ZONETYPE Ordered DATAPACKING BLOCK 2 0 2 0 2 0 0 0 0 0 0 0 2 0 2 0 2 0 4 3 2 Zone Record A zone record consists of a control line that begins with the keyword ZONE followed by the zone header followed by a set of numerical data called the zone data The contents of the zone footer 152 ASCII File Structure depend upon the type of zone Refer to the following table for an overview of the contents of a zone record Component Notes ZONE The keyword ZONE is required at the start of every zone record The Zone Header is used to specify the type of data in the zone the structure of the data the names of the variables in the zone and more Refer to Zone Header on page 154 for details The data section follows the zone header The arrangement of the data is dependent upon the values of DATAPACKING and VARLOCATION specified in the Zone Header Refer to Data on page 158 for details The contents required for the Zone Footer
107. he Boundary Connections for Zone 2 The final step for creating Zone 2 is to define the boundary connections and call TECPOLY 125 TECZNE112 Step 12 Close the file using TECEND Call TECEND to close the file 3 9 5 Polyhedral Example The following example written in C illustrates how to create a single polyhedral cell using the TecIO library 126 Examples TECZNE112 Examples TECZNE112 Examples TECZNE112 Examples 3 9 6 IJ ordered zone The following example illustrates how to create a simple IJ ordered zone TECZNE112 is called first to initialize the zone 133 TECZNE112 Examples TECZNE112 Examples TECZNE112 3 9 7 Switching between two files In this simplified example information is written to two separate files First one file is created and a zone is written to the file Then a second file is created and a zone and auxiliary data are written to the file The second file is closed and the auxiliary data is written to the first file INTEGER4 DemoTecFil void 138 Examples TECZNE112 Examples TECZNE112 Examples TECZNE112 144 Q Examples 3 9 8 Text Example The following example creates a data file with a single text box reading Sample Text 145 TECZNE112 Examples TECZNE112 3 9 9 Geometry Example The following example creates a da
108. he 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 Specify whether the file is a full data file containing both grid and solution data a grid FileType file or a solution file 0 Full 1 Grid 2 Solution Debu Pointer to the integer flag for debugging Set to 0 for no debugging or 1 to debug When 8 set to 1 the debug messages will be sent to the standard output stdout Pointer to the integer flag for specifying whether field data generated in future calls to VIsDouble TECDAT112 are to be written in single or double precision 0 Single 1 Double Examples Each example in Section 3 9 Examples calls TECINI112 at least once Refer to this section for details TECLAB112 Adds custom labels to the data file Custom Labels can be used for axis labels legend text and tick mark labels The first custom label string corresponds to a value of one on the axis the next to a value of two the next to a value of three and so forth NOTE To work with custom labels you must have at least one zone in your data set A custom label set is added to your file each time you call TECLAB112 You may have up to sixty labels in a set and up to ten sets in a file Each label must be surrounded by double quotes e g Mon Tues Wed etc Custom labels are assi
109. hedral zones 60 FE data see Finite element FE line 15 FE surface 15 FE volume 16 File grid file 43 shared grid 43 solution file 43 File Format ASCII 150 174 Binary Data 209 220 File Header 151 Finite element 13 FE line 15 FE surface 15 FE volume 16 volume data 16 Finite element data ASCII format 183 200 boundary map 165 bricks 184 connectivity list 44 45 161 face neighbors 33 face numbering cell based 163 facemap 163 line segments 183 polygons 184 polyhedra 184 polyhedral format 45 quadrilaterals 184 tetrahedron 184 triangles 183 Full file 43 Function reference TecIO library 28 58 Function sequence binary files 26 G Geometry Record ASCII data 168 171 binary example 148 syntax 37 data ASCII 170 origin positions 41 Global one to many 162 Global one to one 162 Grid sharing 43 Grid File 43 H Header file header 151 zone header 53 I Irregular data 174 L Labels custom binary data 43 Legend text 43 Line Segments 183 Local one to many 162 Local one to one 162 M Metadata see Auxiliary Data N Neighboring elements 164 Nodal 16 Nodal Data 31 158 Nodal data 16 O Ordered Data 174 183 Example binary 133 Examples 2D Field Plot 181 3D Field Plot 182 IJK ordered 178 IJ ordered 177 I ordered 176 Examples ASCH 175 183 IJK ordered data 175 IJ ordered data 174 I ordered data 174 one dimensional 174 three dimensional 175 two dimensional 174 Ordered data 12 Origin positions g
110. hen the variables are declared The first value of each variable is for node one the second value for node two and so on Because this zone contains two quadrilateral elements we must supply 8 values in the connectivity list The first four values define the nodes that form Element 1 Similarly the second four values define the nodes that form Element 2 71 TECZNE112 It is important to provide the node list in either a clockwise or counter clockwise order Otherwise your elements will be misshapen For exam ple if the first two numbers in the above connectivity list were switched the zone would appear as follows Step 6 Define the face neighbor connections for Zone 1 Now that TECNOD has been called the creation of Zone 1 is complete However in this example we will define a face neighbor between Zone 1 and Zone 2 to be created later in the example Face Neighbor connections are used to define connections that are not created via the connectivity list For example local face neighbors may need to be defined when a zone wraps onto itself and global face neighbors may need to be defined to smooth edges across zones Face Neighbors are used when deriving variables and drawing contours In this example we are creating a face neighbor connection between Cell 2 in Zone 1 and Cell 1 in Zone 2 The information required when specifying face neighbors depends upon the type of con nection Refer to Section TECFACE112 on
111. hich is composed of four node points arranged in a quadrilateral Used in 2D and 3D sur face plotting Sharing Variable sharing allows a single storage location to be used by more than one party For example if the X variable is shared between zones five and seven only one storage location is created The storage is not freed by Tecplot until the number of parties accessing the data is reduced to zero Variables and connectivity information may be shared Tetrahedron An element type of finite element volume data which is composed of four node points arranged in a tetrahedron Used in 3D volume plot ting 207 Glossary Triangle An element type of finite element surface data which is composed of three node points arranged in a triangle Used in 2D and 3D surface plotting Unordered or Unorganized Data See Irregular Data Zone A subset of a data set which is assigned certain plot types Zones may be activated plotted or deactivated not plotted Each zone has one type of data ordering I IJ IJK or finite element Zones are typi cally used to distinguish different portions of the data For example different calculations experimental versus theoretical results different time steps or different types of objects such as a wing surface versus a vector field around a wing Zone Layers One way of displaying a 2D or 3D plots data set The plot is the sum of the
112. ide provides detailed infor mation about how to format your FE data in Tecplot s data file format 2 2 1 Line Data Unlike I ordered data a single finite element line zone may consist of multiple disconnected sec tions The values of the variables at each data point node are entered in the data file similarly to I ordered data where the nodes are numbered with the I index This data is followed by another set of data defining connections between nodes This second section is often referred to as the connec tivity list All elements are lines consisting of two nodes specified in the connectivity list 2 2 2 Surface Data In finite element surface data you can choose by zone to arrange your data in three point trian gle four point quadrilateral or variable point polygonal elements The number of points per node and their arrangement are determined by the element type of the zone If a mixture of quadri laterals and triangles is necessary you may repeat a node in the quadrilateral element type to create a triangle or you may use polygonal elements 15 Data Structure 2 2 3 Volume Data Finite element volume cells may contain four points tetrahedron eight points brick or variable points polyhedral The figure below shows the arrangement of the nodes for tetrahedral and brick elements The connectivity arrangement for polyhedral data is governed by the method in which the polyhedral facemap data is supplied
113. ifies the origin height box attributes and text Note that the control line for the text can span multiple file lines if necessary as in the third text record below The last text record is an example of using 3D text in Tecplot 360 TEXT X 50 Y 50 T Example Text TEXT X 10 Y 10 F TIMES BOLD C BLUE T Blue Text TEXT X 25 Y 90 CS FRAME HU POINT H 14 BX FILLED BXF YELLOW BXO BLACK LS 1 5 T Box Text Min Multi lined text TEXT CS GRID3D X 0 23 Y 0 23 2 0 5 T Well 1 4 3 4 Geometry Record Geometry records are used to import geometries from a data file Geometries are line drawings that may be boundaries arrows or even representations of physical structures You may create data files containing only geometry and text records and read them into Tecplot 360 You may delete and edit geometries originating from data files just like the geometries that you create interactively The geometry record control line begins with the keyword GEOMETRY Geometry Record Contents Token Available Notes Values GEOME Keyword required to start a geometry record TRY T lt geomtype gt Geometry type F Geometry data format lt datapacking gt DT lt datatype gt Data type ZN lt integer gt Attach text to a specific zone or XY mapping For further information see Section 18 1 2 Text Options in the User s Manual x lt double gt Specify the x origin y origin and z o
114. in Tecplot 360 once you have loaded your data is not limited by your zone type You may have a 3D zone displayed in a 2D Car tesian plot and visa versa TECZNE112 FORTRAN Syntax INTEGER 4 FUNCTION TECZNE112 ZoneTitle RARA CHARACTER INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 DOUBLE PRECISION 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 h INTEGER4 ZoneType IMxOrNumPts JMxOrNumElements KMxOrNumFaces ICellMax JCellMax KCellMax SolutionTime StrandID ParentZone IsBlock NumFaceConnections FaceNeighborMode TotalNumFaceNodes NumConnectedBoundaryFaces TotalNumBoundaryConnections PassiveVarList ValueLocation ShareVarFromZone ShareConnectivityFromZone ZoneTitle ZoneType IMxOrNumPts JMxOrNumElements KMxOrNumFaces ICellMax JCellMax KCellMax Solution Time StrandID ParentZone IsBlock NumFaceConnections FaceNeighborMode TotalNumFaceNodes NumConnectedBoundaryFaces TotalNumBoundaryConnections PassiveVarList ValueLocation ShareVarFromZone ShareConnectivityFromZone TECZNE112 char ZoneTitle INTEGER4 ZoneType INTEGER4 IMxOrNumPts INTEGER4 JMxOrNumElements INTEGER4 KMxOrNumFaces INTEGER4 ICellMax 54 TECZNE112 Return Value INTEGER4 INTEGER4 DOUBLE INTEGER4 INTEGER4 I
115. ine You can specify points in either single or double precision by setting the pt datatype parameter to either SINGLE or DOUBLE Origin positions Geometry types are selected with the T geomtype parameter The available geometry types are listed below SQUARE A square with lower left corner at x Y RECTANGLE A rectangle with lower left corner at x Y e CIRCLE A circle centered at x Y ELLIPSE An ellipse centered at x Y LINE A set of 2D polylines referred to as multi polylines anchored at x Y LINE3D A set of 3D polylines referred to as multi polylines anchored at x Y 2 Geometry Record Examples e Rectangle The following geometry record defines a rectangle of 40 width and 30 height GEOMETRY T RECTANGLE 40 30 WIDTH HEIGHT e Circle The following geometry record defines an origin and a red circle of 20 radius with an origin of 75 75 that is filled with blue GEOMETRY X 75 Y 75 T CIRCLE C RED FC BLUE CS FRAME 170 ASCII File Structure 20 RADIUS e Polyline The following geometry record defines an origin and two polylines drawn using the Custom 3 color The first polyline is composed of three points the second of two points GEOMETRY X 50 Y 50 T LINE C CUST3 Number of points X Y coordinates X Y coordinates X Y coordinates Number of points X Y coordinates X Y coordinates HONNDOOWMN NO OOF Number of polylines in of of of in of
116. ions for Zone 2 We will now specify the face neighbor connection with respect to our new current zone of Zone 2 Zone 1 Zone 2 Step 11 Close the file Call TECEND to close the file 75 TECZNE112 Summary When the preceding code is compiled and built the data file will look as follows with the Mesh and Edge layers turned on Zone 1 Zone 2 With the Mesh layer deactivated the data set will look as follows Zone 1 Zone 2 If we had not included face neighbor connections an Edge line would be drawn in between the two zones 76 Examples 3 9 2 Polygonal Example The following example written in C illustrates how to create a single octagonal cell using the TecIO library In order to keep the example as simple as possible error checking is not included If you plan to compile this example be sure to include TECIO h and malloc h The source files for this example are included in your Tecplot 360 installation under the util tecio polyhedral octagon subdirectory For complete details on the parameters used and the function syntax for each TecIO function refer to Section 3 7 Binary Data File Function Reference When creating a binary data file using the TecIO library the functions must be called in a specific order Refer to Section 3 4 Binary Data File Function Calling Sequence for details Step 1 Initia
117. l be passed into TECDAT112 in BLOCK or POINT format O POINT 1 BLOCK 56 TECZNE112 Parameter Applies to Zone Type s Notes ORDERED TELIT STG Used for cell based finite element and ordered zones Numkace connec 0 nly The number of face connections that will b on FEQUADRILATERAL MY Tie number offs comesios vi FETETRAHEDRON ca nn FEBRICK ORDERED Used for cell based finite element and ordered FELINESEG zones only The type of face connections that will be i FETRIANGLE passed in routine TECFACE112 FaceNeighborMode PRQUADRILATERAL 0 LocalOneToOne FETETRAHEDRON 2 GlobalOneToOne 1 LocalOneToMany FEBRICK 3 GlobalOneToMany Used for face based finite element zones Total number of nodes for all faces It is also the sum of the TotalNumFaceNodes FEPOLYGON FaceNodeCounts array defined in TECPOLYI 12 FEPOLYHEDRON For polygonal zones this value is equivalent to 2 NumFaces NumFaces the number of faces in the zone Refer to Section 3 8 2 FaceNodeCounts and FaceNodes for simple example Used for face based finite element zones Total NumConnected FEPOLYGON o of PE faces iram nn faces se BoundaryFaces FEPOLYHEDRON aces t at either have DER th an one neighboring ce on a side or have a neighboring cell from another zone Refer to Section 3 8 1 Boundary Faces and Boundary Connections for simple example Used for face based finite element zones Total number of bo
118. le you must provide either a total number of values equivalent to NumPts if the variables are nodal or a total number of values equivalent to NumElements if the variables are cell centered The variable location is specified by the VarLocation parameter in TECZNE In this example X and Y are nodal variables and P is cell centered The order in which the variable values must be provided is established by the numbering scheme specified at the beginning of the example The first value for each nodal variable X and Y corre sponds to Node 1 the second value corresponds to Node 2 and so forth The first value for the cell centered value is for Element 1 the second value is for the second element or cell and so forth In order for the example to be easily followed the grid coordinates are explicitly defined When working with larger data sets you will likely wish to use equations to define your coordinates Refer to the picture in Step 2 for the X and Y coordinate values for Zone 1 111 TECZNE112 Examples Step 4 Specify the face map data for Zone 1 Use the picture in Step 2 to specify the nodes that compose each face The first two values in the face node array define Face 1 the next two define Face 2 and so on 113 TECZNE112 Examples Step 5 Specify the neighboring elements for Zone 1 Now that we have defined the nodes that compose each face we must specify the element on either side of each
119. leading up to the error preplot dset dat d You can set the flag to d2 or d3 or d4 and so forth to obtain more detailed information In the following Preplot command line the number of points that are written to the binary data file dset plt is less than the number of points in the input file dset dat preplot dset dat iset 3 6 34 2 jset 3 1 21 1 iset 4 4 44 5 For zone three Preplot outputs data points with I index starting at six and ending at 34 skipping every other one and J index starting at one and ending at 21 For zone four Preplot outputs data points with the I index starting at four ending at 44 and skipping by five In the following Preplot command line every other point in the I J and K directions is written to the binary data file preplot dset dat iset 2 jset 2 kset 2 201 ASCII Data The zone start and end parameters are not specified so all zones are used starting with index one and ending with the maximum index The overall effect is to reduce the number of data points by a factor of about eight 202 Chapter 5 Glossary The following terms are used throughout the Data Format Guide and are included here for your reference 2D Plotting in two dimensions Line plots of one or more variables XY and Polar Line plots are not considered 2D 2D Cartesian Plot A plot of some variable by location on a single plane using two axes 3D Plottin
120. lists the element number for each of its adjacent elements Then each boundary face lists the zone number for each of its adjacent elements The number of the face is not specified but is implicit first face listed is 1 and corresponds to 1 in the left right neighbor list the second is 2 and corresponds to 2 etc Connectivity Sharing The connectivity list and face neighbor connections for cell based finite element zones or the facemap data for face based finite element zones may be shared between zones by using the con NECTIVITYSHAREZONE parameter in the control line of the current zone The format is CONNECTIVITYSHAREZONE nnn where nnn is the number of the zone that the connectivity is shared from To use connectivity shar ing the zone must have the same number of points and elements and be the same zone type 4 3 3 Text Record Text records are used to import text directly from a data file Text can also be imported into Tecplot 360 using a macro file You may create data files containing only text records and read them into Tecplot 360 just as you would read any other data file You may delete and edit text originating from data files just like text created interactively The text record consists of a single control line The control line starts with the keyword TEXT and has one or more options 165 ASCII Data Text Record Toke Syntax
121. lize the data file using TECINI TECINI is required for all data files It is used to open the data file and initialize the file header information name the data file the variables for the data file and the file type 1 You may notice that malloc is used throughout the example This is done to clearly indicate the dimensions required for each array It is not required in practice 77 TECZNE112 Step 2 Create Zone 1 After TECINI is called call TECZNE to create one or more zones for your data file 78 Examples TECZNE112 Step 3 Define node numbering For this example we will create a single octagonal cell Before defining your variables you must establish a consistent node numbering scheme for your data Once the node numbers are defined supply the variable values in the node numbering order In this example Node 1 is defined at X 25 and Y 0 As such the first value supplied for X i e X 0 is 25 Similarly the first value supplied for Y is 0 It is important that you refer to node numbers consistently The node numbers will be used later to define the connectivity for each element 80 Examples Step 4 Set up the variable values Write the variable values to the file using TECDAT Because we are specifying nodal variables as specified via the ValueLocation parameter in TECZNE each variable is dimensioned by the number of points NumPts in the Zone You have the
122. ll zones in the selection Field Plot Includes 2D Cartesian and 3D Cartesian plot types Generally used to display the spacial relationship of data Mesh Contour Vector Scatter and Shade are all considered field plots XY and Polar Line plots and the Sketch plot type are not field plots Finite Element A type of data point ordering Data is arranged by listing the data points called nodes and then listing their relationships called ele ments The element type of the zone determines the number of nodes which are contained in each element as well as the exact relationship of nodes within an element There are several different element types supported by Tecplot Triangle Quadrilateral Tetrahedron Brick Polygonal and Polyhedral See also Connectivity List and Node 205 Glossary I Ordered A type of data point ordering where each point is listed one at a time that is by one index Used mainly in XY plots In 2D or 3D this type of data point ordering is sometimes called irregular and is only useful for scatter plots or for interpolating or triangulating into 2D 3D sur face or 3D volume zones This type of data can also be used for 2D or 3D vector plots if streamtraces are not required IJ Ordered A type of data point ordering where the points are arranged in a 2D array used for 2D and 3D surface plotting IJK Blanking A feature to include or exclude portions of an
123. lobal The table below shows Cartesian coordinates X and Y of six locations and the pressure measured there at three different times P1 P2 P3 The XY locations have been arranged into finite ele ments xX Y Py P P3 1 0 0 0 100 110 120 0 0 0 0 125 135 145 1 0 0 0 150 160 180 0 5 0 8 150 165 175 0 5 0 8 175 185 195 0 0 1 6 200 200 200 For this case we want to set up three zones in the data file one for each time measurement Each zone has three variables X Y and P The zones are of the triangle element type meaning that three nodes must be used to define each element One way to set up this data file would be to list the complete set of values for X Y and P for each zone Since the XY coordinates are exactly the same for all three zones a more compact data file can be made by using the VARSHARELIST In the data file given below the second and third zones have variable sharing lists that share the values of the 185 ASCII Data X and Y variables and the connectivity list from the first zone As a result the only values listed for the second and third zones are the pressure variable values Note that the data could easily have been organized in a single zone with five variables Since blank lines are ignored in the data file you can embed them to improve readability A plot of the data is shown in Figure 4 10 Mesh Pressure 1 188 75 1775 166 25 155 15F 15 143 75
124. ly Cell centered variable DATA SECTION To make reading of cell centered binary data efficient Tecplot stores IMax JMax KMax numbers of cell centered values where IMax JMax and KMax represent the number of points in the I J and K directions Therefore extra zero values ghost values are written to the data file for the slowest moving indices For example if your data s IJK dimensions are 2x3x2 a cell centered variable will have 1x2x1 i e I 1 x J 1 x K 1 significant values However 2x3x2 values must be written out because it must include the ghost values Assume that the two significant cell centered values are 1 5 and 12 5 The ghost values will be output with a zero value So if the zone was dimensioned 2x3x2 its cell centered variable would be represented as follows 1 5 0 0 12 5 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 If the zone was dimensioned 3x2x2 its cell centered variable would be represented as follows 1 5 12 5 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 and if the zone was dimensioned 2x2x3 its cell centered variable would be represented as follows 1 5 0 0 0 0 0 0 12 5 0 0 0 0 0 0 0 0 0 0 0 0 0 0 For large variables the wasted space is less significant that it is for the small example above 220 Anchor Index A Anchor text position 167 ASCII Data conversion to binary 149 200 Custom Label Record 171 File Format 150 174 finite element data 183 200 Geometry Record 168 171 ordered data 17
125. mData YOrRGeomData ZGeomData MFC XOrThetaPos YOrRPos ZPos PosCoordMode AttachToZone Zone Color FillColor TECGEO112 INTEGER 4 IsFilled INTEGER 4 GeomType INTEGER 4 LinePattern DOUBLE PRECISION PatternLength DOUBLE PRECISION LineThicknessness 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 REAL 4 REAL 4 XOrThetaGeomData YOrRGeomData ZGeomData CHARACTER MFC C Syntax include INTEGER4 double double INTEGER4 INTEGER4 INTEGER4 INTEGER4 INTEGER4 INTEGER4 INTEGER4 INTEGER4 double double INTEGER4 INTEGER4 INTEGER4 double double INTEGER4 INTEGER4 INTEGER4 INTEGER4 float float float char TECIO h TECGEO112 double XOrThetaPos YOrRPos ZPos PosCoordMode AttachToZone Zone Color FillColor IsFilled GeomType LinePattern PatternLength LineThicknessness NumEllipsePts ArrowheadStyle ArrowheadAttachment ArrowheadSize ArrowheadAngle Scope Clipping NumSegments NumSegPts XOrThetaGeomData YOrRGeomData ZGeomData MFC Return Value 0 if successful 1 if unsuccessful 38 TECGEO112 Parameters Parameter Description XPos Pointer to double value specifying the X position or
126. n counts 1 boundary connection elements 1 boundary connection zones 2 Polyhedral complex example A single tetrahedron bounded on face two by zone two elements 13 and 14 and on face three by zone three element 11 Zone ZoneType FEPolyhedron Nodes 4 Faces 4 Elements 1 TotalNumFaceNodes 12 NumConnectedBoundaryFaces 2 TotalNumBoundaryConnections 3 variable values in block format node count per face 3333 face nodes 123 UNA bbb PUN left elements negative indicates boundary connection 0 1 2 0 right elements 1111 boundary connection counts 21 boundary connection elements 13 14 11 boundary connection zones 223 4 6 ASCII Data File Conversion to Binary Although Tecplot 360 can read and write ASCII or binary data files binary data files are more compact and are read into Tecplot 360 much more quickly Your Tecplot 360 distribution includes Preplot which converts ASCII to binary data files You can also use Preplot to debug ASCII data files that Tecplot 360 cannot read 200 ASCII Data File Conversion to Binary 4 6 1 Preplot Options To use Preplot type the following command from the UNIX shell prompt from a DOS prompt or using the Run command on Windows platforms preplot infile outfile options where infile is the name of the ASCII data file outfile is an optional name for the binary data file created by Preplot and options is a set of options from eith
127. n frame units LT lt double gt Line thickness in frame units EP lt integer gt Number of points used to approximate circles or ellipses FC lt color gt Fill Color Any geometry type except LINE3D may be filled with a color by using the FC fillcolor parameter Each polyline of a LINE geometry is filled individually by connecting the last point of the polyline with the first Not specifying the FC fillcolor parameter results in a hollow or outlined geometry drawn in the color of the C color parameter AST Arrowhead style lt arrowheadstyl e gt AAT Arrowhead attachment along the line geometry N lt arrowheadatt ach gt ASZ lt double gt Size of arrowhead in frame units AAN lt double gt Angle of arrowhead in degrees MFC lt string gt You may attach a macro function to the text with the MFC parameter The macro function must be a retained macro function that was either set during the current Tecplot session or included in the tecplot mcr file Refer to Section 18 5 Text and Geometry Links to Macros in the User s Manual and SIMACROFUNCTION S ENDMACROFUNCTION on page 180 in the Scripting Guide for additional information CLIPP lt clipping gt plot the geometry within the viewport or the frame ING 169 ASCII Data Data for Geometry Record The control line of the geometry is followed by geometry data For SQUARE the geometry data con sists of just one number the side length of th
128. n of left elements above for more details F NumFaces if total number of boundary faces 0 INT32 NBF Boundary face connection offsets into the 5 boundary face connecion elements array and the boundary face connection zones array The number of elements for a face F is determined by offset o offset o 1 where o is the negative value from either the left or right elements arrays above Offset 0 0 Offset 1 0 so that 1 as the left or right element always indicates no neighboring element If the number of elements is 0 then there is no neighboring element NBF total number of boundary faces 1 218 INT32 NBI Boundary face connection elements A value of 1 indicates there is no element on part of the face NBI total number of boundary connections INT32 NBI Boundary face connection zones A value of A oe pelea 1 indicates the current zone NBI total number of boundary connections NOTES 1 All character data is represented by INT32 values Example The letter A has an ASCII value of 65 The WORD written to the data file for the letter A is then 65 In fortran this could be done by doing the following Integer 32 I I ICHAR A WRITE 10 I All character strings are null terminated i e terminated by a zero value 2 This represents JMax sets of adjacency zero based indices where each set con
129. n to use STDCALL calling con ventions with by reference parameter passing Users of other compilers may need to adjust the Fortran settings or add other compiler directives to achieve the same effect In particular Fortran strings must be NULL terminated and passed without a length argument 3 7 Binary Data File Function Reference This section describes each of the TecIo functions in detail TECAUXSTR112 Writes auxiliary data for the data set to the data file The function may be called any time between TECINI112 and TECEND112 Auxiliary data may be used by text macros equations if it is numeric and add ons It may be viewed directly in the Aux Data page of the Data Set Information dialog accessed via the Data menu FORTRAN Syntax INTEGER 4 FUNCTION TECAUXSTR112 Name amp Value CHARACTER Name CHARACTER Value C Syntax include TECIO h INTEGER4 TECAUXSTR112 char Name char Value Return Value 0 if successful 1 if unsuccessful 28 TECDAT112 Parameters Parameter Description The name of the auxiliary data If this duplicates an existing name the value will over Name write the existing value NOTE It must be a null terminated character string and cannot contain spaces The value to assign to the named auxiliary data NOTE It must be a null terminated Value character string Example For example to set an Auxiliary Variable called Deformatio
130. nValue to 0 98 char DeformationValue 128 strcpy DeformationValue 0 98 TECAUXSTR112 DeformationValue DeformationValue When the data file is loaded into Tecplot Deformation Value will appear on the Aux Page of the Data Set Information dialog when for Data Set is selected in Show Auxiliary Data menu TECDAT112 Writes an array of data to the data file Data should not be passed for variables that have been indi cated as passive or shared via TECZNE112 TECDAT112 allows you to write your data in a piecemeal fashion in case it is not contained in one contiguous block in your program TECDAT112 must be called enough times to ensure that the correct number of values are written for each zone and that the aggregate order for the data is cor rect In the above summary NumVars is based on the number of variable names supplied in a previous call to TECINI112 FORTRAN Syntax INTEGER 4 FUNCTION TECDAT112 N amp Data amp IsDouble INTEGER 4 N REAL or DOUBLE PRECISION Data 1 INTEGER 4 IsDouble 29 TECDAT112 C Syntax include TECIO h INTEGER4 TECDAT112 INTEGER4 N void Data INTEGER4 IsDouble Return Value 0 if successful 1 if unsuccessful 30 TECDAT112 Parameters Parameter Description N Pointer to an integer value specifying number of values to write Data Array of single or double precision data values Refer to Table 3 1
131. nction Notes The pit file that you create will be compatible with the version of Tecplot tied to the version of the TecIO library that you use For example if you use the TecIO library that was bundled with Tecplot 360 Version 2006 your files can be loaded with Tecplot 360 Version 2006 and newer This is independent of the version number used for the binary functions e g the 112 in TECZNE112 For example even if you use 110 functions with the version of the TecIO library included with this dis tribution your plt file will be compatible with this version of Tecplot and newer 3 3 1 Deprecated Binary Functions Functions that end in 111 or less are deprecated We recommend you use the 112 binary function family In order to use the 112 family of functions use the TecIO library included in your Tecplot 360 2008 distribution If you update existing binary function calls to use version 112 you will need to update all of your binary calls The following functions were altered during the upgrade to the 111 family e TECINI The FileType parameter was added TECINI Files from previous versions are of type FULL See Section TECINI112 on page 42 for additional information e TECZNE Three parameters TotalNumFaceNodes NumConnectedBoundaryFaces and TotalNumBoundaryConnections were added to TECZNE111 Refer to Section TECZNE112 on page 53 for details 3 3 2 Character Strings in FORTRAN All character string
132. ng sample FORTRAN code shows how to create an IJK ordered zone in BLOCK format INTEGER VAR WRITE ZONE DATAPACKING BLOCK I IMAX J DO 1 VAR 1 NUMVAR DO 1 K 1 KMAX JMAX K KMAX 178 Ordered Data DO 1 J 1 JMAX DO 1 I 1 IMAX WRITE ARRAY VAR 1 J K 1 CONTINUE Multi Zone XY Line Plot The two tables below show the values of pressure and temperature measured at four locations on some object at two different times The four locations are different for each time measurement Time 0 0 seconds Time 0 1 seconds Position Temperature Pressure Position Temperature Pressure 71 30 563 7 101362 5 71 31 564 9 101362 1 86 70 556 7 101349 6 84 42 553 1 101348 9 103 1 540 8 101345 4 103 1 540 5 101344 0 124 4 449 2 101345 2 124 8 458 5 101342 2 For this case we want to set up two zones in the data file one for each time value Each zone has three variables Position Temperature and Pressure and four data points one for each location This means that Max 4 for each zone We include a text record discussed in Section 4 3 3 Text Record to add a title to the plot The plot shown in Figure 4 6 can be produced from this file SAMPLE CASE Temperature 0 0 seconds Pressure 0 0 seconds Temperature 0 1 seconds Pressure 0 1 seconds 101360 5 520 101355 g 510 E 500 E al 101350 480 F 470 F 460 450 10
133. ng the same data set It is the same as selecting the check box Show in Like Frames in the Text Options dialog BX lt boxtype gt N NOBOX Draw a box around the text string using the BX boxtype parameter The parameters BXO boxoutlinecolor BXM boxmargin and LT linethickness are used ifthe boxtype is HOLLOW or FILLED The parameter BXF boxfillcolor is used only if the boxtype is FILLED The default boxtype NOBOX ignores all other box parameters BXF lt color gt N Box Fill Color BX boxtype must be set to FILLED BXM lt double gt N When BX boxtype is set to HOLLOW or FILLED use the BXM token to specify the margin around text in box as fraction of H text height BXO lt color gt N When BX boxtype is set to HOLLOW or FILLED use the BXO token to specify the color of the box outline LT lt double gt When BX boxtype is set to HOLLOW or FILLED use the LT token to specify the thickness of the box outline F lt font gt N Use the F parameter to specify the font family c lt color gt N Font color AN Use the AN textanchor parameter to specify the position lt textanchor gt of the anchor point relative to the text There are nine possible anchor positions as shown in Figure 4 2 166 ASCII File Structure Toke Syntax Required Y N Default Notes LS lt double gt N 1 Assign the line spacing for multi line text using the LS
134. ng you to load time date data easily from Excel into Tecplot 360 However because Excel software s original for matting incorrectly calculated 1900 as a leap year only dates from Mar 1 1900 forward will import correctly into Tecplot 360 21 Data Structure 22 Chapter 3 Binary Data This chapter is intended for experienced programmers who need to create Tecplot binary data files directly Support for topics discussed in this chapter is limited to general questions about writing Tecplot binary files It is beyond the scope of our Technical Support to offer programming advice and to debug programs Data files for Tecplot 360 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 see Section 4 1 Preplot for additional information To output your data into Tecplot s binary format you may use the static library provided with your Tecplot 360 installation or you may write your own binary functions If you wish to write your own functions refer to Appendix A Binary Data File Format for details on the structure of Tecplot s binary file format If you wish to link with the library provided by Tecplot begin with Section 3 1 Getting Started and use Appendix A Binary Data File Format for reference 3 1 Getting Started Your Tecplot 360 distribution includes a library of utility functi
135. not draw fully obscured boundary faces because it treats those faces as internal faces Tecplot 360 does draw partially obscured boundary faces Thus Tecplot 360 requires definition of partially obscured boundary faces To indicate a partially obscured face indicate the appropriate neighboring element as zero in the FaceBndryConnectionElems and FaceBndryConnectionZones arrays followed by the actual neigh boring elements When Tecplot 360 sees a list of neighboring elements for a boundary face that begin with element zero it marks that boundary face as partially obscured If Tecplot 360 sees a zero in FaceBndryConnectionElems that is not the first boundary element listed for a face an error message will appear indicating that either the partially obscured boundary face was not indicated correctly or FaceBndryConnectionsElems and or FaceBndryConnection sZones was not completely filled out 3 9 Examples The following examples written in C provide a basic illustration of creating a plt file using the TecIO library If you plan to compile the examples be sure to review the instructions in Section 3 6 Linking with the TecIO Library first In order to keep the examples as simple as possible error checking is not included For complete details on the parameters used and the function syntax for each TecIO function refer to Section 3 7 Binary Data File Function Reference When creating a binary data file using the TecIO libra
136. ntation susessesessesenseneesneneenenenenenen 21 Chapter 3 Binary Data nennen 23 Getting Started ui 23 Viewing Your Output essseseessensenssensensenneennennennnnnnnnnnnnnennnn 24 Binary Function Notes coooonononncnonccnonconcnnonncnnon nro conc nc rn noncn non nn 25 Deprecated Binary Functions eseseensnsensensensensnnnnnnnnennen nn 25 Character Strings in FORTRAN eeenenenenensenensensennennn 25 Table of Contents Chapter 4 BOOLEAN EIA id aa 25 Binary Data File Function Calling Sequence n ee 26 Writing to Multiple Binary Data Files oononocnoncncnnoninncnnmmmmem 26 Linking with the TecIO Library enseneennennenn 26 UNIX Linux Macintosh aensseennnensenennenennnnnnnenennennnsnenenn nenn 27 Windows 2nnciu stale vatiticavc chess stents E Henn ern A E E 27 Notes for Windows Programmers using Fortran eee 28 Binary Data File Function Reference 28 Defining Polyhedral and Polygonal Data enene 59 Boundary Faces and Boundary Connections ceeeeeenee 59 FaceNodeCounts and FaceNodes neenenenseennenen 60 FaceRightElems and FaceLeftElems een 62 FaceBoundaryConnectionElements and Zones nnene 63 Partially Obscured Boundary Faces Examplos usa e rere erent cree Face Neighbors siii la daa diri io iaa Poly gonial Example uuuuiinalellensifiel ineislktanegsleiiet
137. of polyline 1 the point 1 the point 2 the point 3 polyline 2 the point 1 the point 2 In BLOCK format the same geometry appears as in in in in in polyline polyline polyline polyline polyline NN hear GEOMETRY X 50 Y 50 T LINE C CUST3 F BLOCK CS FRAME OONPOUN DH oo on Number of polylines Number of points in polyline 1 X position of each point in polyline 1 Y position of each point in polyline 1 2 Number of points in polyline 2 X position of each point in polyline y position of each point in polyline 2 Ellipse The next geometry record defines a purple ellipse with a horizontal axis length of 20 and a vertical axis length of 10 with an origin of 10 70 that is filled with yellow GEOMETRY X 10 Y 70 T ELLIPSE C PURPLE FC YELLOW 20 10 Horizontal Axis Vertical Axis 3D polyline The final geometry record is a 3D polyline with four points that is composed of one polyline using the default origin of 0 O 0 GEOMETRY T LINE3D PWROBF PNNO NWNO Number of polylines Number of points in polyline 1 X Y Z coordinates of point 1 x Y Z coordinates of point 4 In BLOCK format this geometry record can be written as follows GEOMETRY T LINE3D F BLOCK ooo ahr NNE WNW 4 3 5 Custom Labels Record Number of polylines Number of points in polyline 4 X position for each point in 1 Y position for each point in 2 Z position for each point in 1 the
138. onZones Return Value 0 if successful 1 if unsuccessful Parameters Parameter Description An array used to define the number of nodes in each face The array FaceNodeCount is dimensioned by the number of faces defined in TECZNE112 nn This is NULL for polygonal zones as each face in a polygonal zone has exactly two nodes An array used to specify which nodes belong to which face The FaceNodes array is dimensioned by TotalNumFaceNodes defined in TECZNE112 FaceLeftEl An array used to define the left neighboring element for each face en The array is dimensioned by NumFaces defined in TECZNE112 i i i tf h face FaceRightElems An array used to define the right neighboring element for each face The array is dimensioned by NumFaces defined in TECZNE112 FaceBndryConnectionCounts An array used to define the number of boundary connections for each boundary face The array is dimensioned by NumConnectedBound aryFaces defined in TECZNE112 FaceBndryConnectionElems An array used to define the boundary element s to which each boundary face is connected The array is dimensioned by Total NumBndryConnections defined in TECZNE112 FaceBndryConnectionZones An array used to define the zone s to which each boundary element belongs The array is dimensioned by TotalNumBndryConnections defined in TECZNE112 Examples Refer to the following sections for examples using TECPOLY112
139. ons that you can link with your application to create binary data files directly bypassing the use of ASCII files This allows for fewer files to manage conserves disk space and saves the time required to convert the files On UNIX Linux Macintosh platforms the utility functions discussed in Section 3 7 Binary Data File Function Reference are available in the library archive tecio a which is located in the lib directory below the 7EC_360_2008 Directory On Windows platforms this library is called TecIO 1ib and is located in the bin sub directory of your installation When preparing to output your data in Tecplot s binary format using the TecIo library we recom mend you perform the following steps 1 Review Section 3 4 Binary Data File Function Calling Sequence and Section 3 5 Writing to Multiple Binary Data Files in this manual 2 Review the example files provided in the util tecio directory of your Tecplot installa tion The example programs demonstrate the use of the TecIo utility functions and are provided in both FORTRAN and C simtest f simtest f90 simtest c Demonstrates simple use of the TecIo utility functions 23 Binary Data e comtest f comtest 90 comtest c Demonstrates the complex use of TecIo utility functions such as multiple file generation and transient data 3 Follow the instructions in Section 3 6 Linking with the TecIO Library for informa
140. ordered zone the boundary cell faces are on the exterior of the zone That is the first and last I planes the first and last J planes and the first and last K planes For a finite element 3D volume zone boundary cell faces are on the exterior of the zone and the surface of any voids within the zone Brick An element type of finite element volume data composed of eight node points arranged in a hexahedron like format This element type is used in 3D volume plotting Cell Either an element of finite element data or the space contained by one increment of each index of TJ or IJK ordered data Cell Centered Val ues Values located at the center of the cell assumed to be the centroid Connectivity List The portion of a finite element data file which defines the elements or cells by listing the relationships between points The number of points per cell is determined by the element type Custom Labels Text strings contained within a data file or text geometry file which define labels for your axes or contour table You may select Custom Labels anywhere you can choose a number format the result is the text strings in place of numbers The maximum length of a custom label is 1024 characters Data File A file that contains data used for plotting in Tecplot Data Format The type of zone data as specified by the format parameter in a Tecplot data file such as BLOCK or POINT Data Loader A T
141. ovided in order either clockwise or counter clockwise e You must provide the same number of nodes as are included in an element For example you must provide eight numbers for BRICK elements and three numbers for TRIANGLE elements If you are using repeated nodes provide the node number of the repeated node multiple times See also Connectivity Sharing on page 165 The connectivity for face based zones FEPOLYGON and FEPOLYHEDRAL is defined by the Facemap Data refer to Facemap Data on page 163 for details Face Neighbor Connections List For ordered zones the data section may be followed with face neighbor connections For cell based finite element zones the data section and connectivity list may be followed by the face neighbor connection information Use face neighbors to specify connections between zones global connections or connections within zones local connections Face neighbor connections are used by Tecplot when deriving variables or drawing contour lines Specifying face neighbors typically leads to smoother connec tions NOTE face neighbors have expensive performance implications Use face neighbors to manually specify connections that are not defined via the connectivity list Face neighbor connections are defined by the FACENEIGHBORMODE and FACENEIGHBOR CONNECTIONS tokens along with the Face Neighbor Connections list The FACENEIGHBORMODE token is used to specify the type of face neighbor connec
142. 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 use the following syntax I A Hi Mom char 0 3 3 3 Boolean Flags Integer parameters identified as flags indicate boolean values Pass 1 for true and 0 for false 25 Binary Data 3 4 Binary Data File Function Calling Sequence For a given file the binary data file functions must be called in a specific order The order is as follows TECFOREIGN 112 Optional TECINI112 For each call to TECINI112 use one or more of the following commands TECAUXSTR 112 Optional TECVAUXSTR112 Optional TECZNE112 One or more to create multiple zones For each call to TECZNE112 use one of more of these commands TECDAT112 One or more to fill each zone TECNOD112 One for each finite element zone TECFACE112 One for each zone with face connections TECPOLY 112 Optional use for polyhedral data TECZAUXSTR 112 Optional TECLAB112 Optional TECGEO112 Optional TECTXT 112 Optional TECFIL 112 Optional use if you are switching between files TECUSR112 Optional TECEND112 Section 3 5 Writing to Multiple Binary Data Files explains how you can use the TECFIL112 function along with the above functions to write to multiple files simultaneously 3 5 Writing to Multiple Binary Data Files Each
143. pecify if above is 1 0 Node 1 Cell Centered See note 5 Are raw local 1 to 1 face neighbors supplied O FALSE 1 TRUE These raw values are a compact form of the local 1 to 1 face neighbors If supplied Tecplot assumes that the face neighbors are fully specified As such it will not perform auto face neighbor assignment This improves Tecplot s time to first plot See the data section below for format details ORDERED and FELINESEG zones must specify 0 for this value because raw face neighbors are not defined for these zone types FEPOLYGON and FEPOLYHEDRON zones must specify 0 for this value since face neighbors are defined in the face map for these zone types Number of miscellaneous user defined face neighbor connections value gt 0 This value is in addition to the face neighbors supplied in the raw section FEPOLYGON and FEPOLYHEDRON zones must specify 0 if number of miscellaneous user defined face neighbor connections 0 if Ordered Zone User defined face neighbor mode O Local 1 to 1 l Local 1 to many 2 Global 1 to 1 3 Global 1 to many Indicates if the finite element face neighbors are completely specified by the miscellaneous face neighbors given 0 NO 1 YES If yes then Tecplot will not perform auto assignment of face neighbors otherwise all faces not specified are considered boundaries If no then Tecplot will perform auto assignment of the face neighbors unless the raw face neighbor ar
144. ple of node and face numbering for an IJ ordered cell C example of tetrahedron face neighbors Example Refer to Section 3 9 1 Face Neighbors for an example of working with face neighbors In this example face neighbors are used to prevent an Edge line from being drawn between the two zones TECFIL112 Switch output context to a different file Each time TECINI 12 is called the file context is switched to a different file This allows you to write multiple data files at the same time When working with multiple files be sure to call TECFIL112 each time you wish to write to a file This will ensure your data is written to the appropriate file FORTRAN Syntax INTEGER 4 FUNCTION TECFIL112 F INTEGER 4 F C Syntax include TECIO h INTEGER4 TECFIL112 INTEGER4 F Return Value 0 if successful 1 if unsuccessful 35 TECFOREIGN112 Parameters Parameter Description 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 TECINI112 Examples Refer to Section 3 9 7 Switching between two files for a simple example of working with TECFIL112 TECFOREIGN112 Optional function that sets the byte ordering request for subsequent calls to TECINI1 12 The byte ordering request will remain in effect until the next call to this function This has no effect on files already opened via TECINI112 Use this func
145. polyline the polyline the polyline The custom label record is an optional record used to provide custom labels for axes the contour legend or value labels A single custom label record begins with the keyword CUSTOMLABELS fol lowed by a series of text strings The first custom label string corresponds to a value of one on the axis the next to a value of two and so forth 171 ASCII Data You may have up to ten custom label records in a data file The custom label set to use is specified via the Tecplot interface Refer to Section 17 7 1 Creating Custom Labels in the User s Manual for details A simple example of a custom label record is shown below MON corresponds to a value of 1 TUE corresponds to 2 WED to 3 THU to 4 and FRI to 5 Since custom labels have a wrap around effect MON also corresponds to the values 6 11 and so forth CUSTOMLABELS MON TUE WED THU FRI You must include a data set in order to use custom labels You cannot use custom labels in files that contain only text and or geometries 4 3 6 Data Set Auxiliary Data Record There is frequently auxiliary data or Metadata that helps describe the data set For example experimental data may have information about the facility and time at which the data was taken and other parameters that describe the experiment Likewise simulation results have auxiliary data such as reference quantities for non dimensional data needed
146. ray was supplied This option is not valid for ORDERED zones IMax JMax KMax NumPts 211 Binary Data File Format INT32 NumFaces INT32 Total number of face nodes For FEPOLYGON zones this is NumFaces 2 INT32 Total number of boundary faces If any boundary faces exist include one to represent no neighboring element INT32 Total number of boundary connections INT32 NumElements INT32 3 ICellDim JCellDim E KCellDim for future use set to zero For all zone types repeat for each Auxiliary data name value pair INT32 1 Auxiliary name value pair to follow O No more Auxiliary name value pairs If the above is 1 then supply the following INT32 N name string See note 1 INT32 Auxiliary Value Format 2 gt Currently only allow 0 AuxDataType String INT32 N Value string See note 1 Geometries FLOAT32 Geometry marker Value 399 0 INT32 Position CoordSys 0 Grid 1 Frame 2 FrameOffset not used 3 OldWindow not used 4 Grid3D INT32 Scope 0 Global 1 Local INT32 DrawOrder 0 After 1 Befo
147. re FLOAT64 3 X or Theta Y or R Z or dummy i e the starting location 212 INT32 Zone 0 all INT32 Color INT32 FillColor INT32 IsFilled 0 no l yes INT32 GeomType 0 Line 1 Rectangle 2 Square 3 Circle 4 ellipse INT32 LinePattern 0 Solid 1 Dashed 2 DashDot 3 DashDotDot 4 Dotted 5 LongDash FLOAT64 Pattern Length FLOAT64 Line Thickness INT32 NumEllipsePts INT32 Arrowhead Style 0 Plain 1 Filled 2 Hollow INT32 Arrowhead Attachment 0 None 1 Beg 2 End 3 Both FLOAT64 Arrowhead Size FLOAT64 Arrowhead Angle IN32 N Macro Function Command string N Length 1 INT32 l Polyline Field Data Type 1 Float 2 Double GTYPE INT32 Clipping 0 ClipToAxes 1 ClipToViewport 2 ClipToFrame If the geometry type is line then INT32 l Number of polylines
148. right and left neighboring elements for each face The neighboring elements can be determined using the right hand rule For each face place your right hand along the face with your fingers pointing the direction of incrementing node numbers i e from Node 1 to Node 2 The right side of your hand will indicate me Tea aa a a left side of a hand will indicate the left element Refer to Sect for details The number zero is used to indicate that there isn t an element on that side of the face A negative number is used when the neighboring element is in another zone The value of the negative number along with the FaceBndryConnectionCounts array points to the position in the FaceBoundaryCon nectionElems and FaceBoundaryConnectionZones arrays that defines the element and zone numbers of the neighboring element Refer to Step 6 for details Because of the way we numbered the nodes and faces the right element for every face except the face connected to the arrowhead is the element itself Element 1 and the left element is no neigh boring element Element 0 93 TECZNE112 Step 6 Define boundary connections for Zone 1 The last step for defining the rectangular solid is to describe the boundary connections and call TECPOLY 94 Examples 95 TECZNE112 Step 7 Create Zone 2 The data for Zone 1 has been written to the data file so we are ready to create Zone 2 For simplic ity we will reus
149. rigin of the object The x origin and y origin e doubles should be in CS coordinatesys units The z origin of object is for LINE3D geometries only and must always in GRID units Refer to Section Origin 2 lt double gt positions on page 170 for additional information regarding the origin location for each type of geometry R lt double gt Specify the r origin and theta origin ofthe object The origins should be in CS THETA Lani bles units Refer to Section Origin positions on page 170 for additional information cs a Geometry coordinate system If you specify the frame coordinate system the lt coordinatesys values of the X xorigin and Y yorigin parameters are in frame units if you specify grid coordinates X and Y are in grid units that is units of the physical coordinate system Specify X Y and Z for GRID3D coordinates For Polar Line plots you may specify THETA and R instead of X and Y DRAWO lt draworder gt Draw order RDER 168 ASCII File Structure Token Available Notes Values S lt scope gt The S scope parameter specifies the text scope GLOBAL scope attaches the text box to all frames using the same data set It is the same as selecting the check box Show in Like Frames in the Geometry Options dialog c lt color gt Geometry outline color L lt linetype gt Line type PL lt double gt Pattern length i
150. rk or trademark of The Mozilla Foundation in the U S and or other countries Netscape is a registered trademark or trademark of Netscape Commu nications Corporation in the U S and or other countries SUSE is a registered trademark or trademark of Novell Incorporated in the U S and or other countries Red Hat is a registered trademark or trademark of Red Hat Incorporated in the U S and or other countries SPARC is a registered trademark or trademark of SPARC International Incorporated in the U S and or other countries Products bearing SPARC trademarks are based on an architecture developed by Sun Microsystems Inc Solaris Sun and SunRaster are registered trademarks or trademarks of Sun MicroSystems Incorporated in the U S and or other countries Courier is a registered trademark or trademark of Monotype Imaging Incorporated in the U S and or other countries UNIX and Motif are registered trademarks or trademarks of The Open Group in the U S and or other countries Qt is a registered trademark or trademark of Trolltech in the U S and or other countries Zlib is a registered trademark or trademark of Jean loup Gailly and Mark Adler in the U S and or other countries OpenGL is a registered trademark or trademark of Silicon Graphics Incorporated in the U S and or other countries JPEG is a registered trademark or trademark of Thomas G Lane in the U S and or other countries All other product names mentioned herein are trademarks or registered trademarks
151. rved TRADEMARKS Tecplot Tecplot 360 the Tecplot 360 logo Preplot Enjoy the ViewTM and Framer are registered trademarks or trademarks of Tecplot Inc in the United States and other countries 3D Systems is a registered trademark or trademark of 3D Systems Corporation in the U S and or other countries Macintosh OS is a registered trademark or trademark of Apple Incorporated in the U S and or other countries Reflection X is a registered trademark or trademark of Attachmate Corporation in the U S and or other countries EnSight is a registered trademark or trademark of Computation Engineering Internation CEI Incorporated in the U S and or other countries EDEM is a registered trademark or trademark of DEM Solutions Ltd in the U S and or other countries Exceed 3D Hummingbird and Exceed are registered trademarks or trademarks of Hummingbird Limited in the U S and or other countries Konqueror is a registered trademark or trademark of KDE e V in the U S and or other countries VIP and VDB are registered trademarks or trademarks of Halliburton in the U S and or other countries ECLIPSE FrontSim is a registered trademark or trademark of Schlumberger Information Solutions SIS in the U S and or other countries Debian is a registered trademark or trademark of Software in the Public Interest Incorporated in the U S and or other countries X3D is a registered trademark or trademark of Web3D Con sortium in the U S and or other coun
152. ry the functions must be called in a specific order Refer to Section 3 4 Binary Data File Function Calling Sequence for details 3 9 1 Face Neighbors This example illustrates how to 1 create two simple FE quadrilateral zones and 2 create a face neighbor connection between the two zones In order to keep the example as simple as possible error checking is not included If you plan to compile this example be sure to include TECIO h and malloc h 1 You may notice that malloc is used throughout the example This is done to clearly indicate the dimensions required for each array It is not required in practice 64 Examples For Sn a on me paramers used the function syntax for each TecIO function refer to When creating a nn data file dea te TeclO library th the functions must be called ina specific order Refer to ary C for details Step 1 Initialize the data file using TECINI TECINI is required for all data files It is used to open the data file and initialize the file header information name the data file the variables for the data file and the file type 65 TECZNE112 Step 2 Create Zone 1 After TECINI is called call TECZNE to create one or more zones for your data file 66 Examples TECZNE112 Examples amp TotalNumFaceNodes amp NumConnectedBoundaryFaces amp TotalNumBoundaryConnections NULL ValueLocation NULL
153. s for this example are included in your Tecplot 360 installation under the util tecio polyhedral MultiPoly2D subdirec tory For complete details on the parameters used and the function syntax for each TecIO function refer to Section 3 7 Binary Data File Function Reference When creating a binary data file using the TecIO library the functions must be called in a specific order Refer to Section 3 4 Binary Data File Function Calling Sequence for details Step 1 Initialize the Data File The first step for creating a binary data file using the TecIO library is to initialize and open the data file by calling TECINI INTEGER4 I use to check return values INTEGER4 Debug il INTEGER4 VIsDouble 0 INTEGER4 FileType 0 1 You may notice that malloc is used throughout the example This is done to clearly indicate the dimensions required for each array It is not required in practice 106 Examples Q 107 TECZNE112 Step 2 Create Zone 1 3 Hexagons The first step toward creating Zone 1 is to call TECZNE TECZNE is used to initialize the zone and specify parameters that apply to the entire zone e g number of nodes number of elements and variable location 108 Examples TECZNE112 110 Q Examples Step 3 Specify the variable values for Zone 1 The variable values are written to the data file via the TECDAT function For each variab
154. se Set to zero KCellMax N A Reserved for future use Set to zero SolutionTime ALL Scalar double precision value specifying the time associated with the zone Refer to Section 7 2 Time Aware in the User s Manual for additional information on working with transient data StrandID ALL Scalar integer value specifying the strand to which the zone is associated 0 static zone not associated with a strand Values greater than 0 indicate a zone is assigned to a glven strand Refer to Section 7 2 Time Aware in the User s Manual for additional information on strands If you are converting your function calls from func tion calls 109 or older use 0 for StrandID ParentZone ALL Scalar integer value representing the relationship between this zone and its parent With a parent zone association Tecplot 360 can generate a surface streamtrace on a no slip boundary zone A zone may not specify itself as its own parent 0 indicates that this zone is not associated with a parent zone gt 0 A value greater than zero is considered this zone s parent Refer to Section 7 2 Time Aware in the User s Manual for additional information on parent zones and Section 15 3 Surface Streamtraces on No slip Boundaries in the User s Manual for additional information regarding no slip boundaries IsBlock ALL Indicates whether the data wil
155. t and ignored The following simple example of a Tecplot 360 ASCII data file has one small zone and a single line of text TITLE Simple Data File VARIABLES X Y ZONE I 4 DATAPACKING POINT 1 1 2 1 22 12 TEXT X 10 Y 90 T Simple Text 4 3 ASCII File Structure An ASCII data file begins with an file header defining a title for the data file and or the names of the variables The header is followed by optional zone records containing the plot data Zone records may contain ordered or finite element data Refer to Chapter 3 Data Structure in the User s Manual for a complete description of ordered and finite element data You may also include text geometry and custom label records in any order 150 ASCII File Structure The first line in a zone text geometry custom label data set auxiliary data record or variable aux iliary record begins with the keyword ZONE TEXT GEOMETRY CUSTOMLABELS DATASE TAUXDATA or VARAUXDATA Primary Components of ASCII Data Files 4 3 1 File Header The File Header is an optional component of an ASCII data file It may contain a TITLE FILE TYPE and or a VARIABLES list If the file header occurs in a place other than at the top of the data file a warning is printed and the header is ignored This allows you to concatenate two or more ASCII data files before using Tecplot 360 provided each data file has the same number of vari ables per data point
156. ta for varl type ee the amount of storage lt datatype gt Tecplot 360 assigns to each variable pa a Therefore the lowest level data type x gt should be used whenever possible For ze example imaging data which usually consists of numerical values ranging from zero to 255 should be given a data type of BYTE By default Tecplot 360 treats numeric data as data type SINGLE If any variable in the zone uses the BIT data type the DATAPACKING must be BLOCK Refer to Data on page 158 for details DATAPACKI N BLOCK In POINT format the values for all NG lt datapacking variables are given for the first point gt then the second point and so on In BLOCK format all of the values for the first variable are given in a block then all of the values for the second variable then all ofthe values for the third and so forth BLOCK format must be used for cell centered data and polyhedral zones FEPOLYGON FEPOLYHEDRAL 155 ASCII Data Keyword Syntax Required Y N Default Notes VARLOCATI ON set of vars lt varlo cation gt set of vars lt varlo cation gt NODAL Each variable in each zone in a data file may be located at the nodes or the cell centers Each variable is specified as NODAL or CELLCENTERED in the VARLOCATION parameter array All cell centered variables must list one value for each element With nodal variables one value must be
157. ta file with a single square geometry and no zones 148 Chapter 4 ASCIT Data Files exported into Tecplot s data format may be either ASCII or binary However we strongly rec ommend using Tecplot s binary file format plt The ASCII file format is provided to illustrate how data is structured in Tecplot ASCII data format is useful only for very small data files Reading an ASCII data file into Tecplot 360 can be much slower than reading a binary data file as binary data files are structured for more efficient data access and Tecplot 360 must convert from ASCII to binary prior to loading the data Refer to Chapter 3 Binary Data for information on cre ating files in Tecplot s binary format 4 1 Preplot Tecplot 360 or Preplot converts ASCII data files to binary See Section 4 15 Tecplot Format Loader in the User s Manual for converting with Tecplot 360 or Section 4 6 ASCII Data File Conversion to Binary for converting with Preplot A description of the binary format is included in Appendix A Binary Data File Format Finally if your data is generated in FORTRAN or C you may be able to generate binary data files directly using the utilities described in Chapter 3 Binary Data Alternatively you may write your own Tecplot data loader using Tecplot 360 s Add on Developer s Kit ADK Refer to Chapter 27 Creating a Data Loader in the ADK User s Manual for details
158. tains L values and L is for LINESEGS for TRIANGLES for QUADRILATERALS for TETRAHEDRONS for BRICKS or FWD 3 The raw face neighbor array is dimensioned by number of elements for the zone times the number of faces per element where each member of the array holds the zero based element neighbor of that face A boundary face is one that has no neighboring element and is represented by a 1 Faces should only be neighbors if they logically share nodes and they should be reciprocal 4 FaceNeighbor Mode values Data LocalOneToOne 3 cz fz cz LocalOneToMany nz 4 cz fz oz nz czl cz2 czn GlobalOneToOne 4 cz fz 22 C2 GlobalOneToMany 2 nz 4 cz fz oz nz ZZ1 CZ1 Z2Z2 CZ2 2Zn CZn 219 Binary Data File Format Where cz cell in current zone zero based fz face of cell in current zone zero based 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 zero based CZ cell in remote zone zero based cz fz combinations must be unique and multiple entries are not allowed 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 Face neighbors that are not supplied are run through Tecplot s auto face neighbor generator FE on
159. the lt string gt current zone are specified with the AUXDATA parameter in the control line This auxiliary data may be used in dynamic text equations macros or add ons There may be multiple AUXDATA parameters in the control line for a zone but names must be unique NOTE The NAME portion of the string cannot contain spaces Auxiliary data is provided as named strings AUXDATA EXPERIMENTDATE October 13 2007 8 A M 157 ASCII Data Data Tecplot 360 supports the following six data types DOUBLE eight byte floating point values SINGLE four byte floating point values LONGINT four byte integer values SHORTINT two byte integer values BYTE one byte integer values from zero to 255 BIT The arrangement of ASCH data depends upon the combination of datapacking BLOCK or POINT variable location NODAL or CELL CENTERED The zone type also plays a role in that not all forms of datapacking and variable locations are supported by all zone types In BLOCK data the data is arranged by variable while in POINT data the data is arranged by point node or data point depending upon the zone type In NODAL data the variable values are defined at every node FE data or point ORDERED data In CELLCENTERED data the variable values are defined at the center of every cell ORDERED data or element FE data The available combinations of datapacking and variable location parameters are e
160. the viewport or the frame 0 ClipToViewport 1 ClipToFrame Text Character string representing text to display Must be null terminated MFC Macro function command Must be null terminated Examples Refer to Section 3 9 8 Text Example for an example of working with TECTXT112 TECUSR112 Writes a character string to the data file in a USERREC record USERREC records are ignored by Tecplot 360 but may be used by add ons 50 TECVAUXSTR112 FORTRAN Syntax INTEGER 4 FUNCTION TECUSR112 S CHARACTER S C Syntax include TECIO h INTEGER4 TECUSR112 CHAR S Return Value 0 if successful 1 if unsuccessful Parameters Parameter Description S The character string to write to the data file Must be null terminated TECVAUXSTR112 Writes an auxiliary data item to the data file for the specified variable Must be called after TECINI112 and before TECEND112 Auxiliary data may be used by text macros equations if it is numeric and add ons It may be viewed directly in the Aux Data page of the Data Set Information dialog accessed via the Data menu The value can be verified by selecting Variable from the Show Auxiliary Data menu and selecting the corresponding variable number from the menu FORTRAN Syntax INTEGER 4 FUNCTION TECVAUXSTR112 Var Name Value INTEGER 4 Var CHARACTER Name CHARACTER Value C Syntax include TECIO h INTEGER4 TECAUXSTR1
161. tion Tecplot 360 can read in data produced in many different formats including in its own format Refer to Chapter 27 Creating a Data Loader in the ADK User s Manual for information on creating a data loader add on for use with Tecplot 360 This manual describes how to output your data into the Tecplot 360 data format This Data Format Guide includes the following topics e Chapter 2 Data Structure Learn about the different types of data structure available in Tecplot 360 and how to use them e Chapter 3 Binary Data Refer to this chapter for details on outputting data into Tecplot 360 s binary file format plt The chapter also includes instructions for linking with the TecIO library a library of functions used to create binary data included in your distribution Refer to the final section in the chapter for detailed examples e Chapter 4 ASCII Data We strongly recommend that you create binary data files However we provide the ASCII data chapter to allow you to create simple data files e Chapter 5 Glossary Refer to the Glossary for the definitions of terms used throughout the manual Before continuing to either the Binary or ASCII chapter please review this over view of Best Practices Introduction 1 1 Creating Data Files for Both Tecplot 360 amp Tecplot Focus For the purposes of this discussion polyhe oN dral refers to either polyhedral or polygo
162. tion to reverse the byte ordering from the format native to your operating system For example this is useful if you are creating a file on an SGI machine to be used on a Windows or Intel based Linux machine If the function call is omitted native byte ordering will be used FORTRAN Syntax INTEGER 4 FUNCTION TECFOREIGN112 DoForeignByteOrder INTEGER 4 DoForeignByteOrder C Syntax include TECIO h INTEGER4 TECFOREIGN112 INTEGER4 DoForeignByteOrder Return Value 0 if successful 1 if unsuccessful 36 TECGEO112 Parameters Parameter Description DoForeignByteOr Pointer to boolean value indicating if future files created by TECINI112 should be written out in foreign byte order 0 indicates native byte order 1 der ee indicates foreign byte order TECGEO112 Adds a geometry object to the file e g a circle or a square NOTE you cannot set unused param eters to NULL You must use dummy values for unused parameters FORTRAN Syntax INTEGER 4 FUNCTION TECGEO112 XOrThetaPos MOM OM OAM E E DOUBLE PRECISION DOUBLE PRECISION DOUBLE PRECISION INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 YOrRPos ZPos PosCoordMode AttachToZone Zone Color FillColor IsFilled GeomType LinePattern PatternLength LineThicknessness NumEllipsePts ArrowheadStyle ArrowheadAttachment ArrowheadSize ArrowheadAngle Scope Clipping NumSegments NumSegPts XOrThetaGeo
163. tion used The FACENEIGHBORCONNECTIONS token is used to define the total number of face neighbor connections included in the zone The nature of the data arranged in the Face Neighbor Connections list depends upon the FACE NEIGHBORMODE described in the table below To connect the cells along one edge to cells on another edge of the same zone use LOCAL To connect cells of one zone to cells of another zone or 161 ASCII Data zones use GLOBAL If the points of the cells are exactly aligned with the neighboring cell points use ONETOONE If even one cell face is neighbor to two or more other cell faces use ONETOMANY Mode Number of Values Order of Data in the Face Neighbor Connections List LOCALONETOONE 3 cz fz nc LOCALONETOMANY nz 4 cz fz oz nz ncl nc2 nen GLOBALONETOONE 4 cz fz zr cr GLOBALONETOMANY oenetd cz fz oz nz zrl crl zr2 cr2 zrn crn In this table e cz the cell number in the obscured GLOBALONETOMANY list current zone fz the number of the cell face in the current zone zx the remote zone number nc the cell number of the neighbor cell in the current zone oz face obscuration flag zero for face partially obscured one for face entirely nz the number of neighboring cells for the ONETOMANY options nen the number of the th local zone neighboring cell in the list cr the cell number of the neighboring cell in the remote zone zrn
164. tries X Window System is a registered trademark or trademark of X Consortium Incorporated in the U S and or other countries ANSYS Fluent and any and all ANSYS Inc brand product service and feature names logos and slogans are registered trademarks or trademarks of ANSYS Incorporated or its subsidiaries in the U S and or other countries PAM CRASH is a registered trademark or trademark of ESI Group in the U S and or other countries LS DYNA isa registered trademark or trademark of Livermore Software Technology Coroporation in the U S and or other countries MSC NASTRAN is a registered trademark or trademark of MSC Software Corporation in the U S and or other countries NASTRAN is a registered trademark or trademark of National Aeronautics Space Administration in the U S and or other countries 3DSL is a registered trademark or trademark of StreamSim Technologies Incorporated in the U S and or other coun tries SDRC IDEAS Universal is a registered trademark or trademark of UGS PLM Solutions Incorporated or its subsidiaries in the U S and or other countries Star CCM is a registered trademark or trademark of CD adapco in the U S and or other countries FLEXnet is a registered trademark or trademark of Macrovision Corporation and or Macrovision Europe Ltd in the U S and or other countries Python is a registered trademark or trademark of Python Software Foundation in the U S and or other countries Abaqus the 3DS logo SIMULIA and CATIA are registere
165. u nicated to Tecplot implicitly by the order in which you supply the data For example the first nodal value supplied is for Node 1 followed by the value for Node 2 continuing to node N where N is the total number of nodes Similarly for faces and elements The remainder of this section provides simple examples illustrating how to define each of the parameters Of TECPOLY112 3 8 1 Boundary Faces and Boundary Connections A Comnected Boundary Face is a face with at least one neighboring element that belongs to another zone Each Connected Boundary Face has one or more Boundary Connections A Boundary Comnection is defined as the element zone tuple used to identify the neighboring element when the element is part of another zone Consider the following picture Zone 1 Zone 2 A el el fi 2 e2 In the figure shown above Zone 1 contains a single element el and Zone 2 contains two elements el and e2 The boundary faces and boundary connections for each zone are as follows Zone 1 In Zone 1 Face 1 fl is the sole connected boundary face It has two boundary connections The first boundary connection is Element 1 in Zone 2 The second boundary connection is Element 2 in Zone 2 e NumConnectedBoundaryFaces 1 TotalNumBndryConnections 2 59 TECZNE112 Zone 2 In Zone 2 both Face 1 and Face 2 are connected boundary faces There is a total oftwo boundary connections The boundary conne
166. undary connections for all faces In TotalNumBoundary FEPOLYGON ae nn ee be Connections FEPOLYHEDRON equal to NumConnectedBoundaryFaces However TotalNumBoundaryConnections must be greater than or equal to NumConnectedBoundaryFaces Refer to Section 3 8 1 Boundary Faces and Bound ary Connections for simple example 37 TECZNE112 Parameter Applies to Zone Type s Notes Array dimensioned by the number of variables of 4 byte integer values specifying the active passive nature of each variable A value of 0 indicates the Pagsivevatljist ALL associated variable is active while a value of 1 indi cates that it is passive Refer to Passive Variables on page 9 for additional information The location of each variable in the data set Value ValueLocation ALL Location I indicates the location of variable I for this zone 0 cell centered 1 node centered Pass null to indicate that all variables are node centered Indicates variable sharing Array dimensioned by the number of variables ShareVarFromZone l indicates the zone number with which variable I will be shared This reduces the amount of data to be passed via TECDAT112 A value of 0 indicates that the vari able 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 Share VarFromZone ALL Indicates th
167. ure ZONE NODES 14 ELEMENTS 5 DATAPACKING BLOCK ZONETYPE FEBRICK 0 0 1 0 1 0 1 0 1 0 2 0 2 0 2 0 2 0 2 0 2 0 2 0 2 0 2 0 0 0 1 0 0 0 1 0 0 0 2 0 1 0 0 0 2 0 1 0 0 0 2 0 1 0 0 0 0 0 0 0 0 0 1 0 1 0 0 0 0 0 0 0 1 0 1 0 1 0 2 0 2 0 2 0 9 5 14 5 15 0 16 0 15 5 17 0 17 0 17 5 18 5 20 0 17 5 18 0 17 5 16 5 11112453 245371011 8 4455 10 13 14 11 4444912 13 102 244769 10 196 Finite Element Data Figure 4 16 shows the resulting mesh plot from the data set listed in this section Finite Element Volume Tetrahedral Data Set Figure 4 16 A finite element brick zone As a simple example of a finite element volume data set using tetrahedral elements consider the data in Table 4 5 The data set consists of thirteen nodes with seven variables The nodes are to be connected to form twenty tetrahedral elements each with four nodes Table 4 5 Finite Element Volume Tetrahedral data set with 13 nodes and seven variables X Y Z C U V WwW 0 0 95 1 1 0 8 0 85 42 0 5 3 9 sl 26 42 2 22 80 8 50 69 42 6 72 52 9 50 69 42 14 67 48 9 81 26 2 20 30 82 9 0 0 0 1 2 5 10 50 69 43 14 68 48 11 sl 26 43 20 31 82 11 197 ASCII Data Table 4 5 Finite Element Volume Tetrahedral data set with 13 nodes and seven variables X Y Z C U V W 0 85 43 0 84 3 10 81 26 43 2 21 80 11 50 69 43 6 71 51 11 0 0 96
168. with 1 INT32 N Zone Connectivity Data N L JMax see note 2 below 217 Binary Data File Format if zone number to share connectivity lists with 1 amp amp raw local 1 to 1 face neighbors are supplied INT32 N Raw local 1 to 1 face neighbor array de N NumElements NumFacesPerElement See note 3 below if zone number to share connectivity lists with 1 amp amp num of misc user defined face neighbor connections 0 INT32 N Face neighbor connections gt N number of miscellaneous user defined face neighbor connections P See note 4 below if ZoneType is FEPOLYGON or FEPOLYHEDRON if zone number to share face map data with 1 INT32 F Face node offsets into the face nodes array 5 5 below Does not exist for FEPOLYGON zones F NumFaces 1 INT32 FN Face nodes array containing the node numbers for all nodes in all faces FN total number of face nodes INT32 F Elements on the left side of all faces Boundary faces use a negative value which is the negated offset into the face boundary connection offsets array A value of 1 indicates there is no left element F NumFaces INT32 F Elements on the right side of all faces See descriptio
169. ype For cell based zone types FETRIANGLE FEQUADILATERAL FETETRAHEDRON and FEBRICK the nodal data is followed by the connectivity section The connectivity section describes arrangement of cells relative to one another There must be numelements lines in the second section each line defines one element The number of nodes per line in the connectivity list depends on the element type specified in the zone control line ZONETYPE parameter For example ZONETYPE FETRIANGLE has three numbers per line in the connectivity list If nodes five seven and eight are connected one line reads 5 7 8 Refer to Section Connectivity on page 161 for details You may also define Face Neighbors following the connectivity list Refer to Section Face Neighbor Connections List on page 161 for details For face based zone type FEPOLYGON and FEPOLYHEDRAL the data section Section Data on page 158 is followed by the zone footer and facemap data sections Refer to Section Facemap Data on page 163 for details 4 5 1 Variable and Connectivity List Sharing The VARSHARELIST in the ZONE record allows you to share variables from specified previous zones The CONNECTIVITYSHAREZONE parameter in the ZONE record allows you to share the connectivity list from a specified previous zone The following is an example to illustrate these features NOTE Connectivity and or face neighbors cannot be shared when the face neighbor mode is set to G

Tecplot 360 Data Format Guide

Contents

Download Pdf Manuals

Related Search

Related Contents