withtol

Допуск времени к индексированию строки расписания

Синтаксис

S = withtol(rowTimes,tol)

Описание

пример

S = withtol(rowTimes,tol) создает индекс, чтобы выбрать строки расписания. S выбирает все строки, времена строки которых совпадают со временем в rowTimes в допуске, заданном tol. Аргумент rowTimes является datetime или массивом длительности или массивом ячеек из символьных векторов, которые задают даты и времена. tol должен быть значением длительности.

Если rowTimes содержит значения datetime, то можно только использовать S, чтобы преобразовать в нижний индекс в расписание, времена строки которого являются значениями datetime. Точно так же, если rowTimes содержит значения длительности, то можно только использовать S, чтобы преобразовать в нижний индекс в расписание, времена строки которого являются значениями длительности.

Примеры

свернуть все

Создайте расписание, которое содержит данные о температуре и давлении с временами строки в часах. Во времена строки существует небольшое случайное отклонение. Выберите строки с временами строки, которые совпадают с соответствующими временами во временном векторе в допуске пяти секунд.

Time = datetime(2015,12,18) + hours(1:10)' + seconds(randn(10,1));
Temp = [37.3 39.1 42.3 42.6 43 43.9 44.1 43.3 42.5 42]';
Pressure = [29.4 29.6 30.0 30.0 30.1 29.9 29.9 29.8 29.6 29.7]';
TT = timetable(Time,Temp,Pressure)
TT=10×3 timetable
            Time            Temp    Pressure
    ____________________    ____    ________

    18-Dec-2015 01:00:00    37.3      29.4  
    18-Dec-2015 02:00:01    39.1      29.6  
    18-Dec-2015 02:59:57    42.3        30  
    18-Dec-2015 04:00:00    42.6        30  
    18-Dec-2015 05:00:00      43      30.1  
    18-Dec-2015 05:59:58    43.9      29.9  
    18-Dec-2015 06:59:59    44.1      29.9  
    18-Dec-2015 08:00:00    43.3      29.8  
    18-Dec-2015 09:00:03    42.5      29.6  
    18-Dec-2015 10:00:02      42      29.7  

Создайте временной вектор, охватывающий часы с 3:00 до 8:00.

newTimes = datetime(2015,12,18) + hours(3:8)
newTimes = 1x6 datetime array
Columns 1 through 3

   18-Dec-2015 03:00:00   18-Dec-2015 04:00:00   18-Dec-2015 05:00:00

Columns 4 through 6

   18-Dec-2015 06:00:00   18-Dec-2015 07:00:00   18-Dec-2015 08:00:00

Выберите строки TT с временами строки, которые совпадают с временами в newTimes в течение пяти секунд.

S = withtol(newTimes,seconds(5));
TT2 = TT(S,:)
TT2=6×3 timetable
            Time            Temp    Pressure
    ____________________    ____    ________

    18-Dec-2015 02:59:57    42.3        30  
    18-Dec-2015 04:00:00    42.6        30  
    18-Dec-2015 05:00:00      43      30.1  
    18-Dec-2015 05:59:58    43.9      29.9  
    18-Dec-2015 06:59:59    44.1      29.9  
    18-Dec-2015 08:00:00    43.3      29.8  

Входные параметры

свернуть все

Времена, чтобы соответствовать в расписании, заданном как массив datetime, массив длительности, массив ячеек из символьных векторов или массив строк. rowTimes содержит времена, которые точно не совпадают с временами во времена строки расписания, но это может быть в заданном допуске.

Если rowTimes является массивом ячеек из символьных векторов или массивом строк, то элементы массива задают даты и времена, которые могут преобразовать datetime или функции duration.

Допуск к соответствию с временами ко временам строки расписания, заданного как длительность, вектор символов или скаляр строки.

Если tol является вектором символов или скаляром строки, то tol задает время, когда функция duration может преобразовать.

Введенный в R2017b