XEXTRACT

Purpose:

Extracts a portion of a series or table based on X values.

Syntax:

XEXTRACT(series, xstart, xend, offset)

series	-	A series or table.
xstart	-	A real, the starting X value.
xend	-	Optional. A real, the ending X value. Defaults to the series extent.
offset	-	Optional. A real, the X offset of the resulting series. Defaults to xstart, the starting X value.

Returns:

A series or table, the extracted result.

Example:

W1: 1..100;setdeltax(1/100)

W2: xextract(w1, 1.2, 1.25)

W2 == {21, 22, 23, 24, 25, 26} with an XOFFSET of 1.2 and a DELTAX of 0.01.

Example:

W1: 1..100;setdeltax(1/100)

W2: xextract(w1, 1.2, 1.25, 0.0)

Same as above except the XOFFSET is set to 0.0.

Example:

W1: gnorm(1000, 1/100)

W2: xextract(W1, 3)

Extracts 700 points of W1 from 3 seconds to 9.99 seconds.

Example:

W1: gnorm(1000, 1/100)

W2: xextract(W1, -10, 20)

Preserves W1 but prepends zeros from -10 seconds to 0 seconds and appends zeros from 10 seconds to 20 seconds. The resulting series contains 3001 samples.

Remarks:

If xstart is negative, zeros are prepended to the result. If xend is beyond the end of the series, the result is padded with zeros.

See XEXTRACTWIN to extract a section of a series from multiple Windows based on X values.

See EXTRACT to extract a section of a series based on indices.

See COLEXTRACT to extract a column specific number of points from each column of an array.

XEXTRACT

Purpose:

Syntax:

Returns:

Example:

Example:

Example:

Example:

Remarks:

See Also: