overlapsrange

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

Описание

пример

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

Область значений значений времени строки TT определяется его минимальным и максимальным временами строк.

пример

tf = overlapsrange(TT,oneTime) определяет, является ли область значений значений времени строк TT содержит время, заданное как oneTime.

пример

[tf,whichRows] = overlapsrange(___) также возвращает логические индексы, указывающие, какие строки 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,25-1,0 секунд. Чтобы создать объект, используйте timerange функция. Его входами являются длительности, которые можно создать используя seconds функция.

rangeOfTimes = timerange(seconds(0.25),seconds(1.0))
rangeOfTimes = 
	timetable timerange subscript:

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

	See Select Timetable Data by Row Time and Variable Type.

Определите, указаны ли строки TT перекрыть области значений, заданные как rangeOfTimes.

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

Создайте другой объект области значений с областью значений 0,7-1,0 секунды. The overlapsrange функция возвращает 0, потому что rangeOfTimes полностью вне области значений TT.

rangeOfTimes = timerange(seconds(0.7),seconds(1.0))
rangeOfTimes = 
	timetable timerange subscript:

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

	See Select Timetable Data by Row Time and Variable Type.

tf = overlapsrange(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.5),'StartTime',seconds(0.25))
TT2=3×1 timetable
      Time      Readings
    ________    ________

    0.25 sec       74   
    0.75 sec       83   
    1.25 sec       99   

Определите, является ли область значений значений времени строки в TT1 перекрывает область значений значений времени строк в TT2.

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

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

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 = overlapsrange(TT,oneTime)
tf = logical
   1

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

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

tf = overlapsrange(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] = overlapsrange(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 function, и задайте начальное и конечное время области значений явно в качестве входов timerange.

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

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

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

свернуть все

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

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

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

[tf,whichVars] = (TT,rangeOfTimes);
TT2 = T(whichRows,:)
Введенный в R2020a