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.

See Also:

COLEXTRACT

CONCAT

CURXEXTRACT

CUT

DECIMATE

EXTRACT

EXTRACTWIN

RAVEL

REGION

REMOVE

SERPAD

XEXTRACTWIN