The ungriddedTableDef
element defines a set of non-orthogonal data points, along with their independent values
(coordinates), corresponding with the dependent value of an arbitrary function.
A 'non-orthogonal' data set, as opposed to a gridded or 'orthogonal' data set, means that the independent values are not laid out in an orthogonal grid. This form must be used if the dependent coordinates in any table dimension cannot be expressed by a single monotonically-increasing vector.
See the examples below for two instances of ungridded data.
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.
ungriddedTableDef* : [utID, name, units] description? : (description character data) provenance? : author : name, org, [email] address? : (address character data) functionCreationDate : (date in YYYY-MM-DD format, character data) documentRef* : docID modificationRef* : modID uncertainty? : effect (normalPDF : numSigmas | uniformPDF : symmetry ) dataPoint+ :
ungriddedTableDef
attributes:
utID
A mandatory XML-legal name that is unique within the file
name
An optional UNICODE name for the table (may be same as gtID
.
units
Optional units-of-measure for the table's output signal.
ungriddedTableDef
sub-elements:
description
The optional description element allows the
author to describe the data contained within this
ungriddedTable
.
provenance
The optional provenance element allows the
author to describe the source and history of the data within this
ungriddedTable
.
uncertainty
This optional element, if present, describes the uncertainty of this parameter. See the section on Statistics below for more information about this element.
dataPoint
One or more sets of coordinate and output numeric values of the function at various locations within it's input space. This element includes one coordinate for each function input variable. Parsing this information into a usable interpolative function is up to the implementor. By convention, the coordinates are listed in the same order that they appear in the using function.
Example 9.
An example of an ungriddedTableDef
element, encoding the data shown
in figure 2.
Note that in this example, the Mach breakpoints are orthogonally spaced while the angle of attack breakpoints are not; this is still an 'ungridded' table since at least one independent variable has non-orthogonal spacing.
<ungriddedTableDef name="CLBASIC as function of flap angle and angle of attack" utID="CLBAlfaFlap_Table" units="ND"> <description> CL basic as a function of flap angle and angle of attack. Note the alpha used in this table is with respect to the wing design plane (in degrees). Flap is in degrees as well. </description> <provenance> <author name="Peter Grant" org="UTIAS"/> <functionCreationDate date="2006-11-01"/> <documentRef refID="PRG1" /> </provenance> <!--For ungridded tables you provide a list of dataPoints--> <dataPoint> 1.0 -5.00 -0.44 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 1.0 10.00 0.95 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 1.0 12.00 1.12 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 1.0 14.00 1.26 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 1.0 15.00 1.32 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 1.0 17.00 1.41 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 5.0 -5.00 -0.55 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 5.0 0.00 -0.03 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 5.0 5.00 0.50 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 5.0 10.00 1.02 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 5.0 12.00 1.23 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 5.0 14.00 1.44 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 5.0 16.00 1.63 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 5.0 17.00 1.70 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 5.0 18.00 1.75 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 10.0 -5.00 -0.40 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 10.0 14.00 1.57 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 10.0 15.00 1.66 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 10.0 16.00 1.75 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 10.0 17.00 1.80 <!-- alfawdp, flap, CLB--></dataPoint> <dataPoint> 10.0 18.00 1.84 <!-- alfawdp, flap, CLB--></dataPoint> </ungriddedTableDef>
This two-dimensional function table is an example provided by Dr. Peter Grant of the
University of Toronto. Such a table definition would be used in a subsequent
function
to describe how an output variable would be defined based
on two independent input variables. The function table doesn't indicate which input
and output varialbes are represented; this information is supplied by the
function
element later so that a single function table can be
reused by multiple functions.
Example 10.
An excerpt from a sample aero model giving an example of a three-dimensional
ungriddedTableDef
element, encoding the data shown in figure 3.
In this example, the dependent coordinates all vary in each dimension.
<!--===================================--> <!-- Three-D Table Definition Example --> <!--===================================--> <ungriddedTableDef name="yawMomentCoefficientTable1" units="ND" utID="yawMomentCoefficientTable1"> <dataPoint> -1.8330592 -5.3490387 -4.7258599 -0.00350641</dataPoint> <dataPoint> -1.9302179 -4.9698462 0.2798654 -0.0120538</dataPoint> <dataPoint> -2.1213095 -5.0383145 5.2146443 -0.0207089</dataPoint> <dataPoint> 0.2522004 -4.9587161 -5.2312860 -0.000882368</dataPoint> <dataPoint> 0.3368831 -5.0797159 -0.3370540 -0.0111846</dataPoint> <dataPoint> 0.2987289 -4.9691198 5.2868938 -0.0208758</dataPoint> <dataPoint> 1.8858257 -5.2077654 -4.7313074 -0.00219842</dataPoint> <dataPoint> 1.8031083 -4.7072954 0.0541231 -0.0111726</dataPoint> <dataPoint> 1.7773659 -5.0317988 5.1507477 -0.0208074</dataPoint> <dataPoint> 3.8104785 -5.2982162 -4.7152852 -0.00225906</dataPoint> <dataPoint> 4.2631596 -5.1695257 -0.1343410 -0.0116563</dataPoint> <dataPoint> 4.0470946 -5.2541017 5.0686926 -0.0215506</dataPoint> <dataPoint> -1.8882611 0.2422452 -5.1959304 0.0113462</dataPoint> <dataPoint> -2.1796091 0.0542085 0.2454711 -0.000253915</dataPoint> <dataPoint> -2.2699103 -0.3146657 4.8638859 -0.00875431</dataPoint> <dataPoint> 0.0148579 0.1095599 -4.9639500 0.0105144</dataPoint> <dataPoint> -0.1214591 -0.0047960 0.2788827 -0.000487753</dataPoint> <dataPoint> 0.0610233 0.2029588 5.0831767 -0.00816086</dataPoint> <dataPoint> 1.7593356 -0.0149007 -5.0494446 0.0106762</dataPoint> <dataPoint> 1.9717048 -0.0870861 0.0763833 -0.000332616</dataPoint> <dataPoint> 2.0228263 -0.2962294 5.1777078 -0.0093807</dataPoint> <dataPoint> 4.0567507 -0.2948622 -5.1002243 0.010196</dataPoint> <dataPoint> 3.6534822 0.2163747 0.1369900 0.000312733</dataPoint> <dataPoint> 3.6848003 0.0884533 4.8214805 -0.00809437</dataPoint> <dataPoint> -2.3347682 5.2288720 -4.7193014 0.02453</dataPoint> <dataPoint> -2.3060350 4.9652745 0.2324610 0.0133447</dataPoint> <dataPoint> -1.8675176 5.0754646 5.1169942 0.00556052</dataPoint> <dataPoint> 0.0004379 5.1220145 -5.2734993 0.0250468</dataPoint> <dataPoint> -0.1977035 4.7462188 0.0664495 0.0124083</dataPoint> <dataPoint> -0.1467742 5.0470092 5.1806131 0.00475277</dataPoint> <dataPoint> 1.6599338 4.9352809 -5.1210532 0.0242646</dataPoint> <dataPoint> 2.2719825 4.8865093 0.0315210 0.0125658</dataPoint> <dataPoint> 2.0406858 5.3253471 5.2880688 0.00491779</dataPoint> <dataPoint> 4.0179983 5.0826426 -4.9597629 0.0243518</dataPoint> <dataPoint> 4.2863811 4.8806558 -0.2877697 0.0128886</dataPoint> <dataPoint> 3.9289361 5.2246849 4.9758705 0.00471241</dataPoint> <dataPoint> -2.2809763 9.9844584 -4.8800790 0.0386951</dataPoint> <dataPoint> -2.0733070 9.9204337 0.0241722 0.027546</dataPoint> <dataPoint> -1.7624546 9.9153493 5.1985794 0.0188357</dataPoint> <dataPoint> 0.2279962 9.8962508 -4.7811258 0.0375762</dataPoint> <dataPoint> -0.2800363 10.3004593 0.1413907 0.028144</dataPoint> <dataPoint> 0.0828562 9.9008011 5.2962722 0.0179398</dataPoint> <dataPoint> 1.8262230 10.0939436 -4.6710211 0.037712</dataPoint> <dataPoint> 1.7762123 10.1556398 -0.1307093 0.0278079</dataPoint> <dataPoint> 2.2258599 9.8009720 4.6721747 0.018244</dataPoint> <dataPoint> 3.7892651 9.8017197 -4.8026383 0.0368199</dataPoint> <dataPoint> 4.0150716 9.6815531 -0.0630955 0.0252014</dataPoint> <dataPoint> 4.1677953 9.8754433 5.1776223 0.0164312</dataPoint> </ungriddedTableDef>