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.

../../_images/auto_xyz_CreateHull.png

id-803056