binmask

Получите матрицу маски двоичных последовательностей

Описание

seqs = binmask(msk) возвращает матрицу маски двоичных последовательностей, seqs, на основе источника и свойств в msk.

пример

seqs = binmask(msk,len) задает длины последовательностей в seqs.

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

Примеры

свернуть все

Рассмотрим интересующую видимая область (ROI) маску таблицы с четырьмя необходимыми областями, охватывающими выборки, пронумерованные от 2 до 19. Задайте метки категорий следующим A, B, и C. Используйте маску для создания signalMask объект.

roiTbl = table([2 5; 7 10; 15 18; 17 19],["A" "B" "C" "A"]');

m = signalMask(roiTbl);

Извлечение маски двоичных последовательностей из объекта. Задайте длину последовательности из 20 выборок.

binSeqs = binmask(m,20)'
binSeqs = 3x20 logical array

   0   1   1   1   1   0   0   0   0   0   0   0   0   0   0   0   1   1   1   0
   0   0   0   0   0   0   1   1   1   1   0   0   0   0   0   0   0   0   0   0
   0   0   0   0   0   0   0   0   0   0   0   0   0   0   1   1   1   1   0   0

Сократите необходимые области на одну выборку справа и удлините их на две выборки налево. Извлеките измененную маску, задав длину последовательности из 18 выборок.

m.RightShortening = 1;
m.LeftExtension = 2;

binSeqs = binmask(m,18)'
binSeqs = 3x18 logical array

   1   1   1   1   0   0   0   0   0   0   0   0   0   0   1   1   1   1
   0   0   0   0   1   1   1   1   1   0   0   0   0   0   0   0   0   0
   0   0   0   0   0   0   0   0   0   0   0   0   1   1   1   1   1   0

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

свернуть все

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

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

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

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

Выход последовательности, заданная как целочисленный скаляр. Области за пределами len игнорируются. Выходная матрица двоичных последовательностей seqs заполнен false значения в этих случаях:

  • SourceType является 'categoricalSequence' или 'binarySequences' и len больше, чем длина исходной последовательности.

  • SourceType является 'roiTable' и len больше максимального индекса области.

Дополнительные сведения о длине выхода см. в разделе Изменение пределов областей.

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

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

свернуть все

Матрица двоичных последовательностей маскируется, возвращается как матрица. i-й столбец seqs содержит последовательность двоичных масок для i-й категории, перечисленной в SelectedCategories свойство msk.

  • Если SourceType является 'categoricalSequence' или 'binarySequences' и len не задан, тогда seqs имеет ту же длину, что и исходная маска.

  • Если SourceType является 'roiTable', затем len необходимо указать.

Когда RightExtension ненулевое и SourceType является 'categoricalSequence' или 'binarySequences', binmask расширяет области, возможно, за пределы длины последовательности, применяет все другие модификации, основанные на LeftExtension, LeftShortening, RightShortening, MergeDistance, и MinLength, а затем обрезает полученную последовательность до исходной длины последовательности или до заданной длины len.

Для получения дополнительной информации о том, как свойства msk влияют на длину seqs, см. «Изменение предела по областям».

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

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

Введенный в R2020b