extractsigroi

Извлеките необходимые области на основе маски сигнала

Описание

пример

sigroi = extractsigroi(msk,x) необходимые области извлечений вектора входного сигнала x на основе источника и свойств в msk.

пример

sigroi = extractsigroi(msk,x,Name,Value) задает аргументы пары "имя-значение" использования дополнительных опций. Можно принять решение конкатенировать извлеченные области и выбрать число регионов, чтобы извлечь на категорию.

[sigroi,limits] = extractsigroi(___) возвращает массив с местоположениями извлеченных конечных точек области.

[sigroi,limits,numroi,cats] = extractsigroi(___) также возвращает numroi, вектор, содержащий число регионов, найденное для каждой из категорий, перечислен в cats.

Примеры

свернуть все

Полагайте, что таблица видимой области (ROI) с тремя областями пометила A и две области пометили B. Используйте таблицу, чтобы создать signalMask объект.

roiTbl = table([2 5; 7 10; 12 13; 15 25; 28 30],["A","B","A","B","A"]');

m = signalMask(roiTbl);

Сгенерируйте массив с простыми числами, меньшими, чем 150. Используйте signalMask возразите, чтобы извлечь начала, заданные в таблице ROI. Отобразите первый набор A начала и первый набор B начала.

prm = primes(150);

rgs = extractsigroi(m,prm);

AB = [rgs{1}{1} rgs{2}{1}]
AB = 4×2

     3    17
     5    19
     7    23
    11    29

Повторите операцию, но теперь конкатенируйте необходимые области для каждой категории. Отобразите первые шесть A начала и последние шесть B начала.

rgs = extractsigroi(m,prm,'ConcatenateRegions',true);

AB = [rgs{1}(1:6) rgs{2}(end-5:end)]
AB = 6×2

     3    71
     5    73
     7    79
    11    83
    37    89
    41    97

Повторите операцию, но теперь проигнорируйте области с двумя выборками или меньше. Отобразите первые шесть A начала и последние шесть B начала.

m.MinLength = 3;

rgs = extractsigroi(m,prm,'ConcatenateRegions',true);

AB = [rgs{1}(1:6) rgs{2}(end-5:end)]
AB = 6×2

     3    71
     5    73
     7    79
    11    83
   107    89
   109    97

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

свернуть все

Маска сигнала в виде signalMask объект.

Пример: signalMask(table([2 4;6 7],["male" "female"]')) задает маску сигнала с male с тремя выборками область и 2D демонстрационный female область.

Пример: signalMask(categorical(["" "male" "male" "male" "" "female" "female" ""]',["male" "female"])) задает маску сигнала с male с тремя выборками область и 2D демонстрационный female область.

Пример: signalMask([0 1 1 1 0 0 0 0;0 0 0 0 0 1 1 0]','Categories',["male" "female"]) задает маску сигнала с male с тремя выборками область и 2D демонстрационный female область.

Входной сигнал в виде вектора.

Пример: chirp(0:1/1e3:1,25,1,50) задает щебет, произведенный на уровне 1 кГц.

Типы данных: single | double
Поддержка комплексного числа: Да

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'ConcatenateRegions',true,'SelectedRegions',[2 4] указывает, что функция извлекает вторые и четвертые области каждой категории и конкатенирует их.

Опция, чтобы конкатенировать извлеченные области сигнала в виде разделенной запятой пары, состоящей из 'ConcatenateRegions' и логическое значение.

  • Если этот аргумент установлен в false, затем каждая ячейка sigroi массив ячеек, соответствующий отдельной области сигнала.

  • Если этот аргумент установлен в true, затем каждая ячейка sigroi вектор из конкатенированных извлеченных областей сигнала для каждой категории, содержавшейся в msk.

Типы данных: логический

Области, выбранные для экстракции в виде разделенной запятой пары, состоящей из 'SelectedRegions' и вектор из целых чисел.

  • Если этот аргумент установлен в 1то extractsigroi извлечения только первая область каждой категории и возвращают его в sigroi.

  • Если этот аргумент установлен в [i j k ...]то extractsigroi извлекает ith, jth, kth и последовательные области каждой категории и возвращают их в sigroi.

Функция игнорирует индексы, больше, чем подарок числа регионов к данной категории.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

свернуть все

Необходимые области сигнала, возвращенные как массив ячеек. Каждая ячейка sigroi содержит массив ячеек с областями сигнала, извлеченными для каждой категории в msk.

  • Если 'ConcatenateRegions' установлен в false, затем каждая ячейка sigroi массив ячеек, соответствующий отдельной области сигнала.

  • Если 'ConcatenateRegions' установлен в true, затем каждая ячейка sigroi вектор из конкатенированных извлеченных областей сигнала для каждой категории, содержавшейся в msk.

Извлеченные пределы области, возвращенные как массив ячеек матриц 2D столбца. Если msk задает SampleRate, пределы области описываются в секундах. Если msk не задает частоту дискретизации, пределы области являются целыми числами, соответствующими, чтобы сигнализировать о демонстрационных индексах.

Число регионов найдено для каждой из категорий в cats, возвращенный как вектор из целых чисел.

Список категорий, возвращенный как вектор из строк.

Введенный в R2020b