auto_xyz_CreateHullΒΆ
auto_xyz_CreateHull calculates a non convex data hull (Full Load Line, WOT) for the given 3D dataset if the data was measured at approx. constant x- (e.g. speed) or y-values.
- bool = auto_xyz_CreateHull(hData)
- bool = auto_xyz_CreateHull(hData, rsTolerance)
- bool = auto_xyz_CreateHull(hData, rsTolerance, nHullType)
- bool = auto_xyz_CreateHull(hData, rsTolerance, nHullType, nLabel)
- bool = auto_xyz_CreateHull(hData, rsTolerance, nHullType, nLabel, nDirection)
Return Value
If the function succeeds, the return value is TRUE (1); otherwise it is FALSE (0).
Parameters
- hData
The handle of a 3D dataset created with XYZCreate.
- rsTolerance
rsTolerence specifies the tolerance of the measured data (Default value = 0.5%)
- nHullType
nHullType specifies the hull type. (Default value = 1) Possible values are:
Value
Meaning
1
Full Load Line (North curve)
2
South curve
3
Complete hull
- nLabel
nLabel specifies the labeling of the data hull. (Default value = 1) Possible values are:
Value
Meaning
1
Label every point
2
Label every 2. point
3
Do not label
- nDirection
nDirection specifies if the data was measured at approx. constant x or y (Default value = 1)
Value
Meaning
1
x = Constant, (Full Load Line or WOT, tow curve)
2
y = Constant (West or East Curve)
Comment
If the original data was measured at constant x- or y-coordinates (e.g. rpm cross sections), the function can compute the non convex data hull. For cross section coordinates, a tolerance can be specified in a percentage of the range of the coordinates.
Example for speed (rpm) cross sections:
The function finds for each cross section value (eg. 1000, 1500, 2000, 2500) the
minimum and maximum value of the corresponding y coordinate. The maximum value
will create the WOT curve and the minimum value will create tow curve. If the
tolerance is 0.5 % and the speed range of the given engine is 1000 to 6000
rpm the absolute Tolerance is +/- 25 rpm.
See also
id-803056