Exponenta Banner
exponenta event banner

containsrange

Определите, содержит ли время строки расписания указанный временной диапазон

свернуть все на странице

Синтаксис

tf = containsrange (TT, значение reyOfTimes)
tf = containsrange (TT, oneTime)
[tf, whichRows] = containsrange (___)

Описание

пример

tf = containsrange(TT,rangeOfTimes) прибыль 1 (true), если диапазон времени строки TT содержит временной диапазон, указанный rangeOfTimes. В противном случае возвращается 0 (false).

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

пример

tf = containsrange(TT,oneTime) определяет, является ли диапазон времени строки TT содержит время, указанное oneTime.

пример

[tf,whichRows] = containsrange(___) также возвращает логические индексы, указывающие, какие строки TT находятся в пределах указанного временного диапазона.

Примеры

свернуть все

Открыть сценарий в реальном времени

Создайте расписание с временем строк от 0 секунд до 0,4 секунды.

Intensity = [100;98.7;95.2;101.4;99.1];
TT = timetable(Intensity,'TimeStep',seconds(0.1))
TT=5×1 timetable
     Time      Intensity
    _______    _________

    0 sec          100  
    0.1 sec       98.7  
    0.2 sec       95.2  
    0.3 sec      101.4  
    0.4 sec       99.1

Создайте объект временного диапазона с диапазоном 0,1-0,35 секунды. Для создания объекта используйте timerange функция. Его входами являются длительности, которые можно создать с помощью seconds функция.

rangeOfTimes = timerange(seconds(0.1),seconds(0.35))
rangeOfTimes = 
	timetable timerange subscript:

		Select timetable rows with times in the half-open interval:
		[0.1 sec, 0.35 sec)

	See Select Timetable Data by Row Time and Variable Type.

Определение времени строки TT содержат диапазон, указанный rangeOfTimes.

tf = containsrange(TT,rangeOfTimes)
tf = logical
   1

Создайте другой объект временного диапазона с диапазоном 0,1-0,9 секунды. Для этого диапазона, containsrange функция возвращает 0, поскольку 0,9 секунды находится за пределами временного диапазона TT.

rangeOfTimes = timerange(seconds(0.1),seconds(0.9))
rangeOfTimes = 
	timetable timerange subscript:

		Select timetable rows with times in the half-open interval:
		[0.1 sec, 0.9 sec)

	See Select Timetable Data by Row Time and Variable Type.


tf = containsrange(TT,rangeOfTimes)
tf = logical
   0
Открыть сценарий в реальном времени

Создайте два расписания с различными временными диапазонами. Расписания также могут иметь различные переменные и различное количество строк.

Intensity = [100;98.7;95.2;101.4;99.1];
TT1 = timetable(Intensity,'TimeStep',seconds(0.1))
TT1=5×1 timetable
     Time      Intensity
    _______    _________

    0 sec          100  
    0.1 sec       98.7  
    0.2 sec       95.2  
    0.3 sec      101.4  
    0.4 sec       99.1  


Readings = [74;83;99];
TT2 = timetable(Readings,'TimeStep',seconds(0.15),'StartTime',seconds(0.05))
TT2=3×1 timetable
      Time      Readings
    ________    ________

    0.05 sec       74   
    0.2 sec        83   
    0.35 sec       99

Определение диапазона времени строки в TT1 содержит диапазон времени строки в TT2.

tf = containsrange(TT1,TT2)
tf = logical
   1

А с другой стороны, диапазон времени строк TT2 не содержит диапазон TT1.

tf = containsrange(TT2,TT1)
tf = logical
   0
Открыть сценарий в реальном времени

Создайте расписание, содержащее цены, устанавливаемые в начале и середине каждого месяца.

Time = datetime({'2018-01-01';'2018-01-15';'2018-02-01';'2018-02-15';
                 '2018-03-01';'2018-03-15'});
Price = randi([85 110],6,1);
TT = timetable(Time,Price)
TT=6×1 timetable
       Time        Price
    ___________    _____

    01-Jan-2018     106 
    15-Jan-2018     108 
    01-Feb-2018      88 
    15-Feb-2018     108 
    01-Mar-2018     101 
    15-Mar-2018      87

Укажите момент времени с помощью datetime функция. На этот раз полночь 1 февраля 2018 года.

oneTime = datetime('2018-02-01')
oneTime = datetime
   01-Feb-2018

Определение диапазона времени строки в TT содержит oneTime.

tf = containsrange(TT,oneTime)
tf = logical
   1

oneTime не обязательно должно соответствовать определенному времени строки TT. Если oneTime - любое время между минимальным и максимальным временем строки TT, то containsrange возвращает значение 1.

oneTime = datetime('2018-02-28 09:23:45')
oneTime = datetime
   28-Feb-2018 09:23:45


tf = containsrange(TT,oneTime)
tf = logical
   1
Открыть сценарий в реальном времени

Создайте расписание.

Intensity = [100;98.7;95.2;101.4;99.1];
TT = timetable(Intensity,'TimeStep',seconds(0.1))
TT=5×1 timetable
     Time      Intensity
    _______    _________

    0 sec          100  
    0.1 sec       98.7  
    0.2 sec       95.2  
    0.3 sec      101.4  
    0.4 sec       99.1

Укажите временной диапазон. Затем определите, какие строки TT находятся в пределах временного диапазона. Второй выходной аргумент, whichRows, - логический массив, элементы которого соответствуют строкам TT. Он содержит 1 для каждой строки, время которой находится в пределах временного диапазона, и 0 для каждой строки, время которой не равно.

rangeOfTimes = timerange(seconds(0.1),seconds(0.35));
[tf,whichRows] = containsrange(TT,rangeOfTimes)
tf = logical
   1


whichRows = 5x1 logical array

   0
   1
   1
   1
   0

Для доступа к строкам в пределах временного диапазона выполните индексирование в TT использование whichRows.

TT2 = TT(whichRows,:)
TT2=3×1 timetable
     Time      Intensity
    _______    _________

    0.1 sec       98.7  
    0.2 sec       95.2  
    0.3 sec      101.4

Входные аргументы

свернуть все

Расписание ввода. Минимальное и максимальное время строки TT определить его диапазон времени.

Временной диапазон, указанный как объект временного диапазона или расписание.

  • Если используется объект временного диапазона, создайте его с помощью timerange и указать время начала и окончания диапазона в явном виде в качестве входных данных для timerange.

  • Если вы используете расписание, то вам не нужно явно указывать начало и конец диапазона. containsrange получает их автоматически из минимального и максимального времени строки расписания.

Одно время, указанное как datetime или duration скаляр.

Выходные аргументы

свернуть все

True или false, возвращается как логическое значение 1 если диапазон времени строки TT содержит временной диапазон, указанный rangeOfTimes или момент времени, указанный oneTime, и логический 0 в противном случае.

Индексы строк в указанном диапазоне времени, возвращаемые в виде логического массива. Можно индексировать в TT использование whichRows.

Например, в этом коде можно использовать второй вывод containsrange для индексации в расписание TT. Расписание TT2 включает только те строки, время строк которых находится в пределах диапазона, заданного rangeOfTimes.

[tf,whichVars] = (TT,rangeOfTimes);
TT2 = T(whichRows,:)

См. также

| | | | | | |

Темы

Представлен в R2020a

Документация MATLAB

Поддержка