auto_xyz_SubΒΆ
auto_xyz_Sub creates a new dataset by subtracting the z coordinates of the given 3D datasets.
-
hDataNew = auto_xyz_Sub(hData, hData2) -
hDataNew = auto_xyz_Sub(hData_Layer, hData2) -
hDataNew = auto_xyz_Sub(hData_Layer, hData2, nSourceType)
Return Value
hDataNew is the handle of the new 3D dataset.
Parameters
-
hData hData is the first dataset handle. The new dataset (hData - hData2) will be added to the diagram of hData.
-
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 dataset handle and the second element is the diagram handle (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. The new dataset is created as follows:
- The overlapping area in the x,y plane of the two datasets is calculated.
- For the overlapping area for each dataset, a new matrix is interpolated. The two new matrices have the same number of rows and columns.
- The operation is performed elementwise on the new interpolated matrices.
- The new dataset is created from the result matrix. The hull is taken from the first dataset.
Example
hPage = auto_LoadTemplate("test.ipw")
ssFile1 = auto_ImportData(GetRootDirectory() + "samples/test1.xls")
hData1 = auto_LoadDataset("Diagram1", "EngSpd", "PME", "TOEL1");
ssFile2 = auto_ImportData(GetRootDirectory() + "samples/test2.xls")
hData2 = auto_LoadDataset("Diagram2", "EngSpd", "PME", "TOEL1");
hLayer = PageGetLayerHandle(hPage, "Diagram3");
hDataNew = auto_xyz_Sub([hData1, hLayer], hData2);
PageReplot(hPage);
History
| Version | Description |
|---|---|
| 5.40.0 | New parameter nSourceType. |
See also
id-385380