auto_xyz_AddΒΆ

auto_xyz_Add creates a new dataset by adding the z-coordinates of the given 3D datasets.

hDataNew = auto_xyz_Add(hData, hData2)
hDataNew = auto_xyz_Add(hData_Layer, hData2)
hDataNew = auto_xyz_Add(hData_Layer, hData2, nSourceType)

Return Value

hDataNew is the handle of the new 3D dataset.

Parameters

hData_Layer

hData_Layer is a vector with one or two elements:

Value Meaning
hData_Layer[1] Handle of a dataset. The new dataset is added to the diagram to which the dataset hData_Layer[1] belongs.
hData_Layer[1, 2] The first element is the handle of a dataset and the second element is the handle of diagram (layer). The new dataset is added to the diagram with the handle hData_Layer[2].
hData2

hData2 Is a second 3D dataset.

nSourceType

nSourceType is one of the following values:

Value Description
1 Use the x,y coordinates of dataset 1 to calculate the result.
2 Use the x,y coordinates of dataset 2 to calculate the result.
3 Use the interpolation matrix to calculate the result (Default)

For type 1 or 2 the z-coordinates for both datasets are calculated at the original x,y-coordinates and the results are added. For type 3 the interpolation matrix is calculated at identical x,y coordinates the than the matrices are added (Default).

If both maps have identical or quasi identical x,y-coordinates the types 1 or 2 will calculate a better result.

Comment

The two datasets can be created from a matrix or from XYZ triples (see auto_xyz_Sub for more about how the calculation is done).

History

Version Description
5.40.0 New parameter nSourceType.

id-491363