resample

Resample timeseries time vector

Syntax

tsout = resample(tsin,timevec)

tsout = resample(tsin,timevec,interpmethod)

tsout = resample(tsin,timevec,interpmethod,code)

Description

tsout = resample(tsin,timevec) resamples a timeseries object tsin using a new time vector timevec. The resample function uses the interpolation method associated with tsin, which you can display using the command getinterpmethod(tsin).

tsout = resample(tsin,timevec,interpmethod) resamples tsin using a specified interpolation method. interpmethod can be 'linear' for linear interpolation or 'zoh' for zero-order hold.

tsout = resample(tsin,timevec,interpmethod,code) applies the quality codes in code to all samples.

Examples

Resample timeseries

Create a timeseries object, and resample it using linear interpolation according to the times in timevec. Compare the original data to the resampled data.

tsin = timeseries([1.1 2.9 3.7 4.0 3.0]',1:5);
tsout = resample(tsin,[1 1.5 3.5 4.5 4.9]);
tsindata = tsin.Data

tsindata = 5×1

    1.1000
    2.9000
    3.7000
    4.0000
    3.0000

tsoutdata = tsout.Data

tsoutdata = 5×1

    1.1000
    2.0000
    3.8500
    3.5000
    3.1000

Input Arguments

tsin — Input timeseries

scalar

Input timeseries, specified as a scalar.

timevec — New time vector

vector

New time vector, specified as a vector of times for resampling.

When the original time vector contains dates and times but timevec is numeric, resample defines timevec relative to the tsin.TimeInfo.StartDate property using the existing units.

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

interpmethod — Interpolation method

'linear' (default) | 'zoh'

Interpolation method, specified as one of the following options:

• 'linear' — Linear interpolation

• 'zoh' — Zero-order hold

code — Quality codes

[] (default) | scalar | vector | multidimensional array

Quality codes, specified as [] or a scalar, vector, or multidimensional array of integers ranging from -128 to 127.

• When the quality code value is a vector, it must have the same length as the time vector. Each element applies to the corresponding data sample.

• When the quality code value is an array, it must have the same size as the data array. Each element applies to the corresponding data element of the data array.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64