containsrange

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

Описание

пример

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

Область значений времен строки 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