auto_xy_CorrelateΒΆ
auto_xy_Correlate creates a new dataset by using the interpolated y-coordinates of the first dataset as x-values and the y-coordinates of the second datset as y-values.
-
hDataNew = auto_xy_Correlate(hData, hData2) -
hDataNew = auto_xy_Correlate(hData_Layer, hData2)
Return Value
hDataNew is the handle of the new dataset.
Parameters
-
hData hData is the handle of a 2D dataset. The new dataset hDataNew will be added to the layer (diagram) in which the dataset hData is located.
-
hData_Layer hData_Layer is a vector with two elements. The first element is a handle of a 2D dataset and the second element is a handle of a layer (diagram) to which the new dataset should be added.
-
hData2 hData2 is a handle of the second 2D dataset.
Comment
The x-coordinates of all given datasets must be strictly increasing The x coordinates of the given datasets do not have to be identical.
The new dataset is calculated as following:
- The x-range is calculated where all datasets overlap.
- The the new x-range a new x-coordinate vector (xs) is calculated which contain the x-coordinates of all given datasets.
- The y-coordinates for each datasets for the new x-vector xs is calculated by linear interpolation.
- The interpolated y-coordinates are correlated element wise (xCorr = Y1, yCorr = Y2).
- A new dataset will be created (xCorr, yCorr).
See also
id-1547845