Note: This page has been translated by MathWorks. Click here to see

To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

Synchronize timetables to common time vector, and resample or aggregate data from input timetables

The `synchronize`

function collects the variables from all
input timetables, synchronizes them to a common time vector, and returns the result as a
single timetable. The effect is similar to a horizontal concatenation, though the input
timetables can have different row times. When the `synchronize`

function synchronizes timetable variables to different times, it also resamples or
aggregates the data in the variables using a method that you specify.

`TT = synchronize(TT1,TT2)`

`TT = synchronize(TT1,TT2,newTimeBasis,method)`

`TT = synchronize(TT1,TT2,newTimeStep,method)`

`TT = synchronize(TT1,TT2,'regular',method,'TimeStep',dt)`

`TT = synchronize(TT1,TT2,'regular',method,'SampleRate',Fs)`

`TT = synchronize(TT1,TT2,newTimes,method)`

`TT = synchronize(TT1,TT2,newTimeBasis)`

`TT = synchronize(TT1,TT2,newTimeStep)`

`TT = synchronize(TT1,TT2,'regular','TimeStep',dt)`

`TT = synchronize(TT1,TT2,'regular','SampleRate',Fs)`

`TT = synchronize(TT1,TT2,newTimes)`

`TT = synchronize(TT1,TT2,___,Name,Value)`

`TT = synchronize(TT1,...,TTN,___)`

`TT = synchronize(`

creates a
timetable, `TT1,TT2`

)`TT`

, that contains all variables from both the
input timetables `TT1`

and `TT2`

, synchronized
to a vector of row times that is the union of the row times from
`TT1`

and `TT2`

. The row times of
`TT`

are in sorted order with no repeated times.

In effect, `synchronize`

horizontally concatenates the
variables of `TT1`

and `TT2`

, even when they
have row times that differ. As a result, `synchronize`

inserts
a missing data indicator in `TT`

wherever it has:

A row time only from

`TT1`

but no corresponding data from the variables of`TT2`

.A row time only from

`TT2`

but no corresponding data from the variables of`TT1`

.

If `TT1`

and `TT2`

have variables with the
same names, then `synchronize`

renames them and copies both
variables into `TT`

.

To interpolate or fill in values in `TT`

using different
methods for different variables, specify the
`VariableContinuity`

property of each input timetable. For
more information, see Retime and Synchronize Timetable Variables Using Different Methods.

`TT = synchronize(`

creates `TT1,TT2`

,`newTimeBasis`

,`method`

)`TT`

by synchronizing the variables from
`TT1`

and `TT2`

to a new time vector
specified by `newTimeBasis`

. `synchronize`

resamples or aggregates data from the variables in `TT1`

and
`TT2`

using the operation specified by
`method`

. The input argument,
`newTimeBasis`

, specifies how
`synchronize`

constructs the row times of
`TT`

from the row times of `TT1`

and
`TT2`

.

For example, if `newTimeBasis`

is `'union'`

and `method`

is `'linear'`

, then
`TT`

contains the row times from `TT1`

and
`TT2`

, and `synchronize`

uses linear
interpolation to resample the data from the input timetables to the output row
times.

`TT = synchronize(`

creates `TT1,TT2`

,`newTimeStep`

,`method`

)`TT`

by synchronizing the variables from
`TT1`

and `TT2`

to a new time vector that
is regularly spaced by the time unit specified by
`newTimeStep`

.

For example, if `newTimeStep`

is `'daily'`

and `method`

is `'mean'`

, then
`TT`

contains row times that are one day apart, and
`TT`

contains daily means for each variable from
`TT1`

and `TT2`

.

`TT = synchronize(`

creates `TT1,TT2`

,`newTimeBasis`

)`TT`

by synchronizing the variables from
`TT1`

and `TT2`

to a new time vector.
`synchronize`

inserts missing data indicators where needed
in `TT`

.

`TT = synchronize(`

creates `TT1,TT2`

,`newTimeStep`

)`TT`

by synchronizing the variables from
`TT1`

and `TT2`

to a new time vector that
is regularly spaced by the time unit specified by
`newTimeStep`

. The `synchronize`

function
inserts missing data indicators where needed in `TT`

.

`TT = synchronize(`

synchronizes timetables with additional options specified by one or more
`TT1,TT2`

,___,`Name,Value`

)`Name,Value`

pairs. You can use this syntax with the input
arguments of any of the previous syntaxes.

`TT = synchronize(TT1,...,TTN,___)`

creates the
timetable, `TT`

, by synchronizing the `N`

timetables `TT1,...,TTN`

. You can use this syntax with the
input arguments of any of the previous syntaxes.