timetable

Methods

Method Reference: timetable.isequal

timetable: TF = isequal (A, B)
timetable: TF = isequal (A, B, …)

Test timetables for equality.

TF = isequal (A, B) returns a logical scalar TF, which is true when the timetables A and B are the same size, carry the same row times, variable names and metadata, and each pair of corresponding variables holds equal values, and false otherwise.

The row times take part in the comparison and the properties that merely describe them do not, so TimeStep, SampleRate and StartTime are excluded. A timetable told its time step at construction therefore equals one that read the same step off the row times it was given, although the two report a different TimeStep once subset to a single row.

Variables are compared by value and not by class, exactly as isequal compares arrays elsewhere, so a timetable holding int8 ([1; 2]) equals one holding [1; 2]. The VariableTypes property, which only restates those classes, takes no part in the comparison. Every other property does: two timetables differing only in Description, UserData, VariableUnits, VariableDescriptions, VariableContinuity or a custom property are not equal.

As with NaN, missing values are never equal, so a missing row time or element anywhere in either timetable makes the result false; use isequaln to treat missing values as equal.

Further timetables may be supplied, as in isequal (A, B, C, …), in which case TF is true only when all of them are equal to one another. Any argument that is not a timetable, a table included, makes the result false rather than raising an error.

Source Code: timetable