dsp.Buffer

(Чтобы быть удаленным) Буферный входной сигнал

Описание

Buffer возразите буферизует входной сигнал. Количество выборок на канал во входе должно равняться различию между размером буфера вывода и буферным перекрытием (т.е. Length - OverlapLength).

Примечание

dsp.Buffer Система object™ будет удалена в будущем релизе. Используйте dsp.AsyncBuffer вместо этого. Для получения дополнительной информации см. Вопросы совместимости.

Буферизовать входной сигнал:

Создайте dsp.Buffer объект и набор его свойства.
Вызовите объект с аргументами, как будто это была функция.

Чтобы узнать больше, как Системные объекты работают, смотрите то, Что Системные объекты? MATLAB.

Создание

Синтаксис

buff = dsp.Buffer

buff = dsp.Buffer(len,ovrlap,ics)

Описание

buff = dsp.Buffer возвращает буферный Системный объект, buff, используемый, чтобы буферизовать входные сигналы с перекрытием.

buff = dsp.Buffer(len,ovrlap,ics) возвращает буферный объект, buff, с Length набор свойств к len, OverlapLength набор свойств к ovrlap, и InitialConditions набор свойств к ics.

Свойства

развернуть все

Если в противном случае не обозначено, свойства являются ненастраиваемыми, что означает, что вы не можете изменить их значения после вызова объекта. Объекты блокируют, когда вы вызываете их и release функция разблокировала их.

Если свойство является настраиваемым, можно изменить его значение в любое время.

Для получения дополнительной информации об изменении значений свойств смотрите Разработку системы в MATLAB Используя Системные объекты (MATLAB).

`Length` — Количество выборок, чтобы буферизовать
64 (значение по умолчанию) | положительное целое число

Задайте количество последовательных выборок от каждого входного канала, чтобы буферизовать. Можно установить это свойство на любое скалярное целое число, больше, чем 0.

Типы данных: double | int32

`OverlapLength` — Сумма перекрытия между выходными параметрами
0 (значение по умолчанию) | положительное целое число

Задайте количество выборок, которыми последовательный выход структурирует перекрытие. Можно установить это свойство на любое скалярное целое число в области значений $0 \leq L < M_{o}$ , где M _o является выходным форматом кадра, заданным Length свойство.

Объект берет выборки L (строки) из текущей производительности и повторяет их в следующем выходе. Объект получает $M_{o} - L$ новые входные выборки прежде, чем распространить буферизированные данные к выходу.

Типы данных: double | int32

`InitialConditions` — Начальный выход
0 (значение по умолчанию) | скаляр | вектор | матрица

Задайте значение начального выхода объекта для случаев ненулевой задержки как скаляр, вектор или матрица.

Когда существует ненулевая задержка, буфер инициализируется к значению (значениям), заданному InitialConditions свойство. Объект читает из буфера, чтобы сгенерировать первый D выборки выхода, где

$D = {\begin{matrix} M_{o} + L & (L \geq 0) \\ M_{o} & (L < 0) \end{matrix}$

Размерности InitialConditions свойство зависит от OverlapLength, L, и содержит ли вход один канал или несколько каналов:

Когда $L \neq 0$ , InitialConditions свойство должно быть скаляром.
Когда $L = 0$ , InitialConditions свойство может быть скаляром, или это может быть вектор со следующими ограничениями:
- Для одноканальных входных параметров, InitialConditions свойство может быть вектором длины _Mo, если _Mi равняется 1 или вектору длины _Mi, если _Mo равняется 1.
- Для многоканальных входных параметров, InitialConditions свойство может быть вектором длины _Mo * N, если _Mi равняется 1 или вектору длины _Mi * N, если _Mo равняется 1.

Для общей буферизации между произвольными форматами кадра, InitialConditions свойство должно быть скалярным значением, которое затем повторяется через все элементы начального выхода (выходов). Однако в особом случае, где вход является 1 N вектором-строкой, и выходом блока является _Mo-by-N матрица, InitialConditions может быть:

_Mo-by-N матрица.
Вектор длины-_Mo, который будет повторен через все столбцы начального выхода (выходов).
Скаляр, который будет повторен через все элементы начального выхода (выходов).

В особом случае, где выход является 1 N вектором-строкой, который является результатом освобождения буфера _Mi-by-N матрица, InitialConditions может быть:

Вектор, содержащий выборки _Mi, чтобы вывести последовательно для каждого канала во время первых шагов расчета _Mi.
Скаляр, который будет повторен через все элементы начального выхода (выходов).

Использование

Синтаксис

y = buff(x)

Описание

y = buff(x) создает выход y на основе текущего входа и сохраненных прошлых значений x . Выходная длина равняется Length свойство.

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

развернуть все

`x` — Ввод данных
вектор-столбец | матрица

Ввод данных, заданный как вектор-столбец или матрица. Количество входных строк должно быть равно Length – OverlapLength.

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

развернуть все

`y` — Буферный выход
вектор-столбец | матрица

Буферный выходной параметр, возвращенный как вектор-столбец или матрица.

Следующая таблица показывает выходные размерности dsp.Buffer Системный объект, когда вход является одноканальным сигналом. M _i - размер входного кадра и M _o, является выходным форматом кадра, заданным Length свойство.

Введите размерности	Выведите размерности
1 на 1 (скаляр)	M _o-1
M _i-1 (вектор-столбец)	M _o-1

Следующая таблица показывает выходные размерности dsp.Buffer Системный объект, когда вход является многоканальным сигналом. Выходной формат кадра, M _o может быть больше или меньше, чем размер входного кадра, _Mi. Объект буферизует каждый из каналов входа N независимо.

Введите размерности	Выведите размерности
1 N (вектор-строка)	M _o-by-N
_Mi-by-N (матрица)	M _o-by-N

Тип данных и сложность выходных соответствий тот из входного сигнала.

Функции объекта

Чтобы использовать объектную функцию, задайте Системный объект как первый входной параметр. Например, чтобы выпустить системные ресурсы Системного объекта под названием obj, используйте этот синтаксис:

release(obj)

развернуть все

Характерный для всех системных объектов

`step`	Запустите алгоритм Системного объекта
`release`	Высвободите средства и позвольте изменения в значениях свойств Системного объекта и введите характеристики
`reset`	Сбросьте внутренние состояния Системного объекта

Примеры

Создайте буфер

Примечание: Если вы используете R2016a или более ранний релиз, заменяете каждый вызов объекта с эквивалентным step синтаксис. Например, obj(x) становится step(obj,x).

Создайте буфер 256 выборок с 128 демонстрационными перекрытиями.

reader = dsp.SignalSource(randn(1024,1),128);
buff = dsp.Buffer(256,128);

for i = 1:8
    y = buff(reader());
end

y имеет длину 256 с 128 выборками от предыдущего входа.

Алгоритмы

Этот объект реализует алгоритм, входные параметры и выходные параметры, описанные на странице с описанием блока Buffer. Свойства объектов соответствуют свойствам блока, за исключением отмеченного.

Вопросы совместимости

развернуть все

dsp. Буферный Системный объект будет удален

Предупреждает запуск в R2019b

dsp.Buffer Системный объект будет удален в будущем релизе. Используйте dsp.AsyncBuffer объект вместо этого.

Обновите код

Эта таблица показывает типичное использование Системного объекта и объясняет, как обновить существующий код, чтобы использовать эквивалентную функцию.

Нежелательное использование (R2016b или позже)	Нежелательное использование (перед R2016b)	Рекомендуемая замена
Буфер без перекрытия signal = randn(512,1); buff = dsp.Buffer(512) y = buff(signal); Буфер с 25%-м перекрытием overlapLen = 128; buffCap = 512; buff = dsp.Buffer(buffCap,overlapLen) y = buff(signal(1:(512-128))); % Number of input samples must equal % Length - OverlapLength.	Буфер без перекрытия buff = dsp.Buffer(512) y = step(buff,signal); Буфер с 25%-м перекрытием overlapLen = 128; buffCap = 512; buff = dsp.Buffer(buffCap,overlapLen) y = step(buff,signal(1:(512-128))); % Number of input samples must equal % Length - OverlapLength.	Асинхронный буфер без перекрытия abuff = dsp.AsyncBuffer; write(abuff,signal) % Write the signal yabuff = read(abuff,512); % Read the entire signal from the buffer Буфер с 25%-м перекрытием abuff = dsp.AsyncBuffer; write(abuff,signal); yabuff = read(abuff,512,128);

Нежелательное использование (R2016b или позже)

Нежелательное использование (перед R2016b)

Рекомендуемая замена

Буфер без перекрытия

signal = randn(512,1);
buff = dsp.Buffer(512)
y = buff(signal);

Буфер с 25%-м перекрытием

overlapLen = 128;
buffCap = 512;
buff = dsp.Buffer(buffCap,overlapLen)
y = buff(signal(1:(512-128)));
% Number of input samples must equal
% Length - OverlapLength.

Буфер без перекрытия

buff = dsp.Buffer(512)
y = step(buff,signal);

Буфер с 25%-м перекрытием

overlapLen = 128;
buffCap = 512;
buff = dsp.Buffer(buffCap,overlapLen)
y = step(buff,signal(1:(512-128)));
% Number of input samples must equal
% Length - OverlapLength.

Асинхронный буфер без перекрытия

abuff = dsp.AsyncBuffer;
write(abuff,signal) % Write the signal
yabuff = read(abuff,512); 
% Read the entire signal from the buffer

Буфер с 25%-м перекрытием

abuff = dsp.AsyncBuffer;
write(abuff,signal);
yabuff = read(abuff,512,128);

Документация

dsp.Buffer

Описание

Примечание

Создание

Синтаксис

Описание

Свойства

`Length` — Количество выборок, чтобы буферизовать
64 (значение по умолчанию) | положительное целое число

`OverlapLength` — Сумма перекрытия между выходными параметрами
0 (значение по умолчанию) | положительное целое число

`InitialConditions` — Начальный выход
0 (значение по умолчанию) | скаляр | вектор | матрица

Использование

Синтаксис

Описание

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

`x` — Ввод данных
вектор-столбец | матрица

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

`y` — Буферный выход
вектор-столбец | матрица

Функции объекта

Характерный для всех системных объектов

Примеры

Создайте буфер

Алгоритмы

Вопросы совместимости

dsp. Буферный Системный объект будет удален

Смотрите также

Системные объекты

Представленный в R2012a

Документация DSP System Toolbox

Поддержка

Документация

dsp.Buffer

Описание

Примечание

Создание

Синтаксис

Описание

Свойства

Length — Количество выборок, чтобы буферизовать64 (значение по умолчанию) | положительное целое число

OverlapLength — Сумма перекрытия между выходными параметрами0 (значение по умолчанию) | положительное целое число

InitialConditions — Начальный выход0 (значение по умолчанию) | скаляр | вектор | матрица

Использование

Синтаксис

Описание

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

x — Ввод данных вектор-столбец | матрица

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

y — Буферный выход вектор-столбец | матрица

Функции объекта

Характерный для всех системных объектов

Примеры

Создайте буфер

Алгоритмы

Вопросы совместимости

dsp. Буферный Системный объект будет удален

Смотрите также

Системные объекты

Представленный в R2012a

Документация DSP System Toolbox

Поддержка

`Length` — Количество выборок, чтобы буферизовать
64 (значение по умолчанию) | положительное целое число

`OverlapLength` — Сумма перекрытия между выходными параметрами
0 (значение по умолчанию) | положительное целое число

`InitialConditions` — Начальный выход
0 (значение по умолчанию) | скаляр | вектор | матрица

`x` — Ввод данных
вектор-столбец | матрица

`y` — Буферный выход
вектор-столбец | матрица