exponenta event banner

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