ug0d

7/27/2019 ug0d

1/22

GAMBIT TURBO FILE FORMAT

Fluent Inc., Mar-06 D-1

D. GAMBIT TURBO FILE FORMAT

Turbo files are ASCII text files that contain numerical descriptions of turbo-

machinery configurations. Such descriptions typically include the locations

and connectivities of points and curves that describe the hub, casing, tip clear-

ance, and blade profiles of the configuration. GAMBIT allows you to import

either of two types of turbo files:

Pro/ENGINEER (IBL)

Native

Pro/ENGINEER (IBL)files are generated by the Pro/ENGINEER CAD pack-

age and are typically assigned the file extension of .ibl. Native files are

structured in the native GAMBIT turbo-file format and are typically assigned

the file extension .tur. This appendix describes the format of native

GAMBIT turbo files.

NOTE (1): The GAMBIT turbo file format defines the sequence in which data

records must appear in the file but does notconstrain the formatting of data on

any particular record. For example, on a record that contains the Cartesian

coordinates of a single point, the coordinates can appear as strictly formatted(for example, 3F6.2) or as unformatted, separated by commas or blank

characters.

NOTE (2): Any data record that begins with a forward slash (/) constitutes a

comment record, and its data is ignored.

Section D.1 describes the general structure of a GAMBIT native turbo file,

including the sequence in which the records must appear in the file. Section

D.2 shows an example turbo file.

7/27/2019 ug0d

2/22

General Structure GAMBIT TURBO FILE FORMAT

D-2 Fluent Inc., Mar-06

D.1 General Structure

The general structure of a GAMBIT turbo file consists of three sections:

Header information

Hub, casing, and tip-clearance data

Blade data

Header information describes the turbo file version number, the rotational

axis, and the coordinate system type used to specify point locations. Hub,

casing, and tip-clearance datadescribe the inner and outer boundaries of the

turbo volume (with respect to the axis of revolution). Blade datadescribes the

shapes of the blades and splitters (optional) that comprise the internal compo-

nents of the turbo volume.

D.1.1 Header Information

The first major section of the turbo file consists of three non-comment data

records that contain headerinformation. Each record appears only once in the

turbo file.

Header information in a GAMBIT turbo file consists of the following items:

File version number

Rotational axis

Coordinate system type

The following subsections describe the items listed above.

7/27/2019 ug0d

3/22

GAMBIT TURBO FILE FORMAT General Structure


File Version Number

The file version numberdocuments the format version for the turbo data file.

Each file version number references a unique record sequence and/or format

for the turbo data.

Format

n(1) n(2) n(3)

Data Descriptions

Item Type Description

n(1) Integer Major version number

n(2) Integer Minor version number

n(3) Integer Revision number

Example

/ FILE VERSION NUMBER 1.2.0

1 2 0

7/27/2019 ug0d

4/22



Rotational Axis

The rotational axisspecifies the coordinate axis about which turbo descriptive

elements, such as the hub and casing edges, are rotated in order to create the

turbo volume.

Format

n

Data Descriptions


n Integer Coordinate axis code, where input values of 0,

1, and 2 represent thex,y, andzcoordinate

axes, respectively.

Example

/ ROTATIONAL AXIS: Y-AXIS

1

7/27/2019 ug0d

5/22



Coordinate System Type

The coordinate system typespecifies the type of the coordinate system point

data used in the turbo data file. The available coordinate system types include:

Cartesian

Cylindrical

(NOTE: For the cylindrical coordinate system, angles must be specified indegrees, not radians.)

Format

n

Data Descriptions


n Integer Coordinate axis code, where input values of 0

and 1 represent the Cartesian and cylindrical

coordinate systems, respectively.

Example

/ COORDINATE SYSTEM TYPE: CARTESIAN

0

7/27/2019 ug0d

6/22



D.1.2 Hub, Casing, and Tip-Clearance Data

The second major section of the turbo file consists of data records that

describe the inner and outer boundaries of the turbo volume. The boundaries

are defined in terms of the following curves:

Hub

Casing

Tip-clearance (optional)

The huband casing data describe sets of connected edges the swept surfaces

of which constitute the inner and outer surfaces of the turbo volume,

respectively. Tip-clearancedata describes a set of connected edges that can be

used to define the shapes of the upper surface(s) of the turbo blades and

splitters.

Each data section contains records that specify the following information:

The number of connected edges in the set

The number of points for each edge

Coordinate data for each point(NOTE: If any edge setfor example, the hub edge setcontains more than

one edge, all endpoints that represent points of connection between edges in

the set must be coincident to within the GAMBIT standard geometry tolerance

(106

).)

The following subsections describe the items listed above.

7/27/2019 ug0d

7/22



Hub Data

Hubdata describes the curve the swept surface of which constitutes the inner

boundary surface of the turbo volume.

Format

ne

nt(1)x(1,1)y(1,1)z(1,1)

x(1,2)y(1,2)z(1,2)

...

x(1,nt(1))y(1,nt(1))z(1,nt(1))

nt(2)

x(2,1)y(2,1)z(2,1)

x(2,2)y(2,2)z(2,2)

...

x(2,nt(2))y(2,nt(2))z(2,nt(2))

.

.

.

nt(ne)

x(ne,1)y(ne,1)z(ne,1)

x(ne,2)y(ne,2)z(ne,2)...

x(ne,nt(ne))y(ne,nt(ne))z(ne,nt(ne))

Data Descriptions


ne Integer Number of edges used to describe the hub

curve

nt(i) Integer Number of points used to describe edge i.

x(i,j)y(i,j)

z(i,j)

Real Coordinate locations (x,y,zor r, ,z) ofpoint jon edge i.

Example

/ HUB DATA: 1 EDGE DEFINED BY 2 POINTS

1

2

-50.0 0.0 255.0

200.0 0.0 255.0

7/27/2019 ug0d

8/22



Casing Data

Casing data describes the curve the swept surface of which constitutes the

outer boundary surface of the turbo volume.

Format

ne

nt(1)x(1,1) y(1,1) z(1,1)

x(1,2) y(1,2) z(1,2)

...

x(1,nt(1)) y(1,nt(1)) z(1,nt(1))

nt(2)

x(2,1) y(2,1) z(2,1)

x(2,2) y(2,2) z(2,2)

...

x(2,nt(2)) y(2,nt(2)) z(2,nt(2))

.

.

.

nt(ne)

x(ne,1) y(ne,1) z(ne,1)

x(ne,2) y(ne,2) z(ne,2)...

x(ne,nt(ne)) y(ne,nt(ne)) z(ne,nt(ne))

Data Descriptions


ne Integer Number of edges used to describe the casing

curve

nt(i) Integer Number of points used to describe edge i.

x(i,j)

y(i,j)

z(i,j)

Real Coordinate locations (x,y,zor r,

,z) ofpoint jon edge i.

Example

/ CASING DATA: 1 EDGE DEFINED BY 2 POINTS

1

2

-50.0 0.0 379.0

200.0 0.0 379.0

7/27/2019 ug0d

9/22



Tip-Clearance Data

Tip-clearancedata describes a curve that can be used to define the shapes of

the upper surface(s) of the turbo blades and splitters. (NOTE: The turbo data

file mustcontain at least one record for tip-clearance data. If the turbo con-

figuration does not include a tip-clearance edge set, you must specify the

number of tip-clearances edges (ne) as zero (0).)

Format

ne

nt(1)

x(1,1) y(1,1) z(1,1)

x(1,2) y(1,2) z(1,2)

...

x(1,nt(1)) y(1,nt(1)) z(1,nt(1))

nt(2)

x(2,1) y(2,1) z(2,1)

x(2,2) y(2,2) z(2,2)

...

x(2,nt(2)) y(2,nt(2)) z(2,nt(2))

.

.

.

nt(ne)

x(ne,1) y(ne,1) z(ne,1)

x(ne,2) y(ne,2) z(ne,2)

...

x(ne,nt(ne)) y(ne,nt(ne)) z(ne,nt(ne))

Data Descriptions


ne Integer Number of edges used to describe the tip-

clearance curve

np(i) Integer Number of points used to describe edge i.

x(i,j)

y(i,j)

z(i,j)

Real Coordinate locations (x,y,zor r, ,z) of

point jon edge i.

7/27/2019 ug0d

10/22



Example

/ TIP-CLEARANCE DATA: 1 EDGE DEFINED BY 2 POINTS

1

2

-50.0 0.0 360.0

200.0 0.0 300.0

7/27/2019 ug0d

11/22



D.1.3 Blade Data

The third major section of the turbo file consists of data records that describe

the blade and (optionally) splitter. Turbo blade data consists of the following

items:

Number of blades

Number of profiles and sides

Profile edge continuity

Pressure- and suction-side data

The number-of-blades data record specifies whether the turbo configuration

consists of a single blade only or of a blade-and-splitter combination and

appears only once in the set of blade data records. The other data records listed

above are repeated for each blade (or splitter). They include the number of

profiles (that is, sets of edges describing the blade cross section), the profile

edge continuity, as well as the edge data that describes the pressure and

suction sides of each blade.

7/27/2019 ug0d

12/22



Number of Blades

The number-of-blades data record specifies whether the turbo configuration

consists of a single blade or a blade-and-splitter combination. This record

appears only once in the turbo data file.

Format

nb

Data Descriptions


nb Integer Number of blades in the turbo configuration:

1 = Blade only

2 = Blade and splitter

Example

/ NUMBER OF BLADES: 1=BLADE ONLY, 2=SPLITTER

1

7/27/2019 ug0d

13/22



Number of Profiles and Sides

The number-of-profiles-and-sidesdata record specifies two items of informa-

tion:

The number of blade profiles (cross sections) that are included in the

turbo data set

The number of edges in each profileside

This record appears once for each blade and/or splitter in the turbo data file.

NOTE (1): You must specify at least two profiles for each blade.

NOTE (2): The leading and trailing endpoints for each side of a given profile

must be coincident to within the GAMBIT geometry tolerance value (106

). If

the leading endpoints for the two sides of a given profile are notcoincident,

GAMBIT repairs the profile by constructing an edge that links the two leading

endpoints and splitting the edge to create two connected edges at the leading

tip of the profile. Similarly, if the trailing endpoints for the two sides of a

given profile are not coincident, GAMBIT constructs an edge that links the

two trailing endpoints and splits the edge to create two connected edges at the

trailing tip of the profile. (For restrictions on this operation, see NOTE (3),

below.)

7/27/2019 ug0d

14/22



NOTE (3): The coincidence repair operation described in NOTE (2), above, is

restricted by two factors:

The continuity of edges at the leading and trailing tips of the profile

A limit on the number of allowable edges on any profile side

With respect to the continuity restriction, GAMBIT repairs configurations that

involve non-coincident leading or trailing profile tips only if the edges arespecified as C(0) continuous at the connecting (that is, leading or trailing)

vertex. (For a description of edge continuity specifications, see Profile Edge

Continuity, below.)

With respect to the edge-number limit, GAMBIT allows a maximum of three

edges to be used in the definition of any profile side. As a result, the ability of

GAMBIT to repair non-coincidence at the leading and/or trailing tip(s) of the

profile is limited by the number of edges specified for the profile. The

limitations can be stated as follows.

If you specify only one edge for each profile side, GAMBIT can

perform the coincidence repair operation on both the leading and

trailing tips of the profile, if necessary.

If you specify twoedges for each profile side, GAMBIT can perform

the coincidence repair operation on eitherthe leading ortrailing tip of

the profile.

If you specify three edges for each profile side, GAMBIT cannot

perform the coincidence repair operation, because the operation would

create at least four edges on each side of the profile.

Format

np(i)

nd(i)

7/27/2019 ug0d

15/22



Data Descriptions


np(i) Integer Number of profiles used to describe blade i.

(NOTE: np(i)2)

nd(i) Integer Number of edges per side used to describeeach profile for blade i.

(NOTE: nd(i)= 1, 2, or 3.)

Example

/ NUMBER OF PROFILES FOR BLADE 1

2

/ NUMBER OF EDGES PER SIDE FOR EACH PROFILE

2

7/27/2019 ug0d

16/22



Profile Edge Continuity

Profile edge continuity defines the continuity between all edges used to

describe blade i. This record appears once for each blade and/or splitter in the

turbo data file.

The allowable edge continuity statesC(0), C(1), and C(2)are defined as

follows (see Figure D-1).

C(0)The edges are connected by a common point (vertex) but the

first and second derivatives of the curves that describe the edges are

not necessarily continuous at the connection point (Figure D-1(a)).

C(1)The edges are connected by a common point (vertex), and the

first derivatives of the curves that describe the edges are continuous at

the connection point (Figure D-1(b)). The second derivatives of the

curves that describe the edges are not necessarily continuous at the

connection point.

C(2)The edges are connected by a common point (vertex), and both

the first and second derivatives of the curves that describe the edges

are continuous at the connection point (Figure D-1(c)).

(a) C(0) continuity (b) C(1) continuity

(c) C(2) continuity

Connection points

Figure D-1: Edge continuity definitions

7/27/2019 ug0d

17/22



NOTE: Profile edge continuity defines continuity between adjacentedges as

observed at their connecting endpoints. Therefore, to fully specify profile edge

continuity, you must specify continuity at the leading and trailing tips of the

profile and at all intermediate points of connection between the edges used to

define the profile. For example, if a profile includes only oneedge per side,

you must specify twocontinuity valuesone for the leading tip of the profile

and one for the trailing tip of the profile. If a profile includes twoedges per

side, you must specify three continuity entriesone each for the profileleading and trailing tips and one for the point of connection between the two

edges that define either side of the profile.

Format

pc(i,1)pc(i,2), ...,pc(i,nd(i+1))

Data Descriptions


pc(i) Integer Profile continuity for all edges used to

describe blade i. (NOTE: Allowable values

include 0, 1, and 2corresponding to C(0),

C(1), and C(2) continuity, respectively.)

nd(i) Integer Number of edges per side used to describe

each profile for blade i(see Number of

Profiles and Sides, above).

Example

/ PROFILE EDGE CONTINUITY

2 2

7/27/2019 ug0d

18/22



Pressure- and Suction-Side Data

Pressure- and suction-side data records contain point data that define the

edges used to describe the pressure and suction sides, respectively, of the

blade and splitter. The point data and record sequences must be organized

according to the following rules.

Point data for each edge must be ordered such that it describes the edge

from its leading endpoint to its trailing endpoint.

The complete description of each profile consists of all point data that

describes thepressureside of the profilefollowed byall point data that

describes thesuctionside of the profile.

The data records must be ordered such that descriptions of the profiles

appear in spanwise order, from the hub to the casing (see the example

turbo data file described in Section D.2, below).

Format

nt(k,1)

x(k,1,1) y(k,1,1) z(k,1,1)

x(k,1,2) y(k,1,2) z(k,1,2)

...x(k,1,nt(k,1)) y(k,1,nt(k,1)) z(k,1,nt(k,1))

Data Descriptions


nt(k,i) Integer Number of points used to describe pressure-

side edge iof profile k.

x(k,i,j)

y(k,i,j)

z(k,i,j)

Real Coordinate locations (x,y,zor r, ,z) of

point jon edge ifor profile k.

7/27/2019 ug0d

19/22



Example

/ PRESSURE-SIDE DATA FOR PROFILE 1 (2 EDGES PER SIDE)

/ EDGE 1

/ NUMBER OF POINTS FOR EDGE 1

4

/ POINT DATA FOR PROFILE 1, PRESSURE SIDE, EDGE 1

0.00 0.00 250.00

9.00 8.64 250.00

21.00 12.72 250.0033.00 18.96 250.00


5

/ POINT DATA FOR PROFILE 1, PRESSURE SIDE, EDGE 2

33.00 18.96 250.00

45.00 27.84 250.00

60.00 44.04 250.00

72.00 61.44 250.00

86.88 78.96 250.00

/

/ SUCTION-SIDE DATA FOR PROFILE 1 (2 EDGES PER SIDE)

/ EDGE 1


4

/ POINT DATA FOR PROFILE 1, SUCTION SIDE, EDGE 10.00 0.00 250.00

9.00 -9.36 250.00

21.00 -11.70 250.00

33.00 -9.84 250.00


5

/ POINT DATA FOR PROFILE 1, SUCTION SIDE, EDGE 2

33.00 -9.84 250.00

45.00 -2.88 250.00

60.00 15.24 250.00

72.00 36.24 250.00

86.88 78.96 250.00

7/27/2019 ug0d

20/22

Example GAMBIT Turbo File GAMBIT TURBO FILE FORMAT


D.2 Example GAMBIT Turbo File

The following example file demonstrates the native GAMBIT turbo file format

described above. The file describes a turbo configuration in which the hub and

casing edges are described by two and one edge(s), respectively, and for which

a tip-clearance edge is defined. The configuration includes a turbo blade and

splitter, each of which is defined by two profiles, and each profile includes

two edges on each side.TURBO EXAMPLE FILE

/

/ FILE VERSION1 3 1

// ROTATIONAL AXIS

2

// COORDINATE SYSTEM TYPE: CARTESIAN

0

// HUB EDGE DATA

22

0 4 -5

0 4 03

0 4 0

0.2 4 2.50 4 5

// CASING EDGE DATA

1

20 10 -5

0 10 5

// TIP-CLEARANCE EDGE DATA

12

0 9 -50 9 5/

/ BLADE DATA: 2 BLADES, 2 PROFILES/BLADE, 2 EDGES/SIDE

2/

/ BLADE 12

2

/ PROFILE EDGE CONTINUITY2 1 0

7/27/2019 ug0d

21/22

GAMBIT TURBO FILE FORMAT Example GAMBIT Turbo File


/ BLADE 1, PROFILE 1, PRESSURE SIDE

30.0 3.8 -3

0.2 3.8 -2

0.5 3.8 02

0.5 3.8 00.1 3.8 3

/ BLADE 1, PROFILE 1, SUCTION SIDE

30.0 3.8 -3

-0.2 3.8 -2

-0.5 3.8 02

-0.5 3.8 0-0.1 3.8 3

/ BLADE 1, PROFILE 2, PRESSURE SIDE

30.0 10.2 -3

0.5 10.2 -21.0 10.2 0

2

1.0 10.2 00.1 10.2 3

/ BLADE 1, PROFILE 2, SUCTION SIDE

30.0 10.2 -3

-0.5 10.2 -2-1.0 10.2 0

2

-1.0 10.2 0-0.1 10.2 3

/

/ BLADE 2 (SPLITTER)2

2/ PROFILE EDGE CONTINUITY

2 1 0

/ BLADE 2 (SPLITTER), PROFILE 1, PRESSURE SIDE3

1.0 3.8 -2

1.1 3.8 -1.51.2 3.8 0

21.2 3.8 0

1.1 3.8 2

/ BLADE 2 (SPLITTER), PROFILE 1, SUCTION SIDE3

1.0 3.8 -2

0.9 3.8 -1.50.8 3.8 0

2

7/27/2019 ug0d

22/22

Example GAMBIT Turbo File GAMBIT TURBO FILE FORMAT


0.8 3.8 0

0.9 3.8 2/ BLADE 2 (SPLITTER), PROFILE 2, PRESSURE SIDE

3

2.0 10.2 -22.2 10.2 -1.5

2.5 10.2 02

2.5 10.2 0

2.1 10.2 2/ BLADE 2 (SPLITTER), PROFILE 2, SUCTION SIDE

3

2.0 10.2 -21.8 10.2 -1.5

1.5 10.2 02

1.5 10.2 0

1.9 10.2 2

Date post:	13-Apr-2018
Category:	Documents
Upload:	sahil-goyal
View:	218 times
Download:	1 times

ug0d

Documents