The griddedTableDef element
defines a multi-dimensional table of values corresponding with the value of an arbitrary
function at the intersection of a set of specified independent inputs. The coordinates
along each dimension are defined in separate breakpointDef elements that are
referenced within this element by bpRefs, one for each dimension.
The data contained within the data table definition are a comma-separated set of floating-point values. This list of values represents a multi-dimensional array whose size is inferred from the length of each breakpoint vector. For example, a two-dimensional table that is a function of an eight-element Mach breakpoint set and a ten-element angle-of-attack breakpoint set is expected to contain 80 comma-separated values.
By convention, the breakpointRefs are listed in order
such that the last breakpoint set varies most rapidly in the associated data table
listing. See Section 6.5.1, “Ordering of points” below.
An optional uncertainty element
may be provided that represents the statistical variation in the values presented. See
the section on Statistics below for more information
about this element.
griddedTableDef* : [gtID, name, units]
description? :
(description character data)
provenanceRef? : provID OR
provenance? :
author : name, org, [email]
address? :
(address character data)
creationDate :
(date in YYYY-MM-DD format, character data)
documentRef* : docID
modificationRef* : modID
breakpointRefs :
bpRef+ : bpID
uncertainty? : effect
(normalPDF : numSigmas | uniformPDF )
dataTable
(character data)
griddedTableDef
attributes:
gtIDAn XML-legal name that is unique within the file.
nameA UNICODE name for the table (may be the same string as
gtID).unitsThe units-of-measure for the table's output signal. See Section 6.5.6, “Units of measure abbreviation” below.
griddedTableDef
sub-elements:
descriptionThe optional description element allows the author to describe the data contained within this
griddedTable.provenanceThe optional provenance element allows the author to describe the source and history of the data within this
ungriddedTable. Alternatively, a<provenanceRef>reference can be made to a previously definedprovenance.breakpointRefsThe mandatory
breakpointRefselement contains separatebpRefelements, each pointing to a separately-definedbreakpointDef. Thus, the independent coordinates associated with this function table are defined elsewhere and only a reference is given here. The order of appearance of thebpRefs is important; see the text above.uncertaintyThis optional element, if present, describes the uncertainty of this parameter. See the section on Statistics below for more information about this element.
dataTableThe numeric values of the function at the function vertices specified by the breakpoint sets are contained within this element, in a single comma-separated list. Parsing this list and storing it in the appropriate array representation is up to the implementor. By convention, the last breakpoint value increases most rapidly.
Example 8. An excerpt showing an example of a griddedTableDef
element
This non-linear function table is used by a subsequent function in
Example 11, “An excerpt giving the example of a function which refers to a previously defined
griddedTableDef” to specify an output value based
on two inputs values - body flap deflection and Mach number. This table is defined
outside of a function element because this particular function
table is used by two functions - one for the left lower body flap and one for the
right lower body flap; thus, their actual independent (input) variable values might be
different.
<!-- ==================================== --> 
<!-- Lower Body Flap Tables (definitions) -->
<!-- ==================================== -->
<griddedTableDef name="CLBFL0" gtID="CLBFL0_table"> 
<description> 
Lower body flap contribution to lift coefficient,
polynomial constant term
</description>
<provenance> 
<author name="Bruce Jackson" org="NASA Langley Research Center" email="[email protected]"/>
<creationDate date="2003-01-31"/>
<documentRef docID="REF01"/>
</provenance>
<breakpointRefs> 
<bpRef bpID="DBFL_PTS"/>
<bpRef bpID="XMACH1_PTS"/>
</breakpointRefs>
<dataTable> <!-- last breakpoint (XMACH) changes most rapidly --> 
<!-- CLBFL0 POINTS -->
<!-- DBFL = 0.0 -->
0.00000E+00 , 0.00000E+00 , 0.00000E+00 , 0.00000E+00 , 0.00000E+00 ,
0.00000E+00 , 0.00000E+00 , 0.00000E+00 , 0.00000E+00 , 0.00000E+00 ,
0.00000E+00 , 0.00000E+00 , 0.00000E+00 ,
<!-- DBFL = 15.0 --> 
-0.86429E-02 ,-0.10256E-01 ,-0.11189E-01 ,-0.12121E-01 ,-0.13520E-01 ,
-0.86299E-02 ,-0.53679E-02 , 0.76757E-02 , 0.11300E-01 , 0.62992E-02 ,
0.51902E-02 , 0.38813E-02 , 0.37366E-02 ,
<!-- DBFL = 30.0 -->
0.22251E-01 , 0.26405E-01 , 0.28805E-01 , 0.31206E-01 , 0.34806E-01 ,
0.31321E-01 , 0.28996E-01 , 0.19698E-01 , 0.18808E-01 , 0.12755E-01 ,
0.10804E-01 , 0.98493E-02 , 0.83719E-02 ,
<!-- DBFL = 45.0 -->
.
. [other points in table]
.
</dataTable>
</griddedTableDef>