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

Overview Automation, PageGetLayerHandle

_id-1547845