dsp.ScalarQuantizerEncoder

Объединенное входное значение со значением индекса области квантования

Описание

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

Закодировать входное значение путем соединения его со значением индекса области квантования:

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

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

Создание

Синтаксис

sqenc = dsp.ScalarQuantizerEncoder

sqenc = dsp.ScalarQuantizerEncoder(Name,Value)

Описание

пример

sqenc = dsp.ScalarQuantizerEncoder возвращает скалярную Систему энкодера квантизатора object™, sqenc. Этот объект сопоставляет каждое входное значение с областью квантования путем сравнения входного значения с заданными пользователями граничными точками.

sqenc = dsp.ScalarQuantizerEncoder(Name,Value) возвращает скалярный объект энкодера квантизатора, sqenc, с каждым заданным набором свойств к заданному значению.

Свойства

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

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

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

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

`BoundaryPointsSource` — Источник граничных точек
`'Property'` (значение по умолчанию) | `'Input port'`

Задайте, как определить граничные точки и значения книги шифров как 'Property' или 'Input port'.

`Partitioning` — Квантизатор ограничен или неограничен
`'Bounded'` (значение по умолчанию) | `'Unbounded'`

Задайте квантизатор как 'Bounded' или 'Unbounded'.

`BoundaryPoints` — Граничные точки областей квантизатора
1:10 (значение по умолчанию) | вектор

Задайте граничные точки областей квантизатора как вектор. Векторные значения должны быть в порядке возрастания. Позвольте [p0 p1 p2 p3 ... pN] обозначьте свойство граничных точек в квантизаторе. Если квантизатор ограничен, объект использует это свойство задать [p0 p1 p2 p3 ... pN]. Если квантизатор неограничен, объект использует это свойство задать [p1 p2 p3 ... p(N-1)] и наборы p0 = -Inf и pN = +Inf.

Настраиваемый: да

Зависимости

Это свойство применяется, когда вы устанавливаете BoundaryPointsSource свойство к Property.

`SearchMethod` — Найдите индекс квантизатора линейным или двоичным поиском
`'Linear'` (значение по умолчанию) | `'Binary'`

Задайте, найти ли соответствующий индекс квантизатора с помощью линейного поиска или двоичного поиска как один из 'Linear' или 'Binary'. Вычислительная стоимость линейного метода поиска имеет порядок, P и вычислительная стоимость метода двоичного поиска имеют порядок

${журнал}_{} 2(P)$

где P является количеством граничных точек.

`TiebreakerRule` — Поведение, когда введенный равняется граничной точке
`'Choose the lower index'` (значение по умолчанию) | `'Choose the higher index'`

Задайте, присвоено ли входное значение ниже индексируемой области или более высокой индексируемой области, когда входное значение равняется граничной точке путем выбора 'Choose the lower index' или 'Choose the higher index'.

`CodewordOutputPort` — Включите выход значения кодовой комбинации
`false` (значение по умолчанию) | `true`

Установите это свойство на true выводить значения кодовой комбинации, которые соответствуют каждому значению индекса.

`QuantizationErrorOutputPort` — Включите выход ошибки квантования
`false` (значение по умолчанию) | `true`

Установите это свойство на true выводить ошибку квантования для каждого входного значения. Ошибка квантования является различием между входным значением и квантованным выходным значением.

`Codebook` — Книга шифров
1.5:9.5 (значение по умолчанию) | вектор

Задайте книгу шифров как вектор квантованных выходных значений, которые соответствуют каждой области. Если Partitioning свойством является 'Bounded' и вектор граничных точек имеет длину N, необходимо установить это свойство на вектор длины N-1. Если Partitioning свойством является 'Unbounded' и вектор граничных точек имеет длину N, необходимо установить это свойство на вектор длины N+1.

Настраиваемый: да

Зависимости

Это свойство применяется, когда вы устанавливаете BoundaryPointsSource свойство к 'Property' и любой CodewordOutputPort свойство или QuantizationErrorOutputPort свойством является true.

`ClippingStatusOutputPort` — Включите выход усечения состояния
`false` (значение по умолчанию) | `true`

Установите это свойство на true выводить состояние усечения. Выход является 1, когда входное значение вне области значений, заданной BoundaryPoints свойство. Когда значение в области значений, исключение, выход является 0.

Зависимости

Это свойство применяется, когда вы устанавливаете Partitioning свойство к 'Bounded'.

`OutputIndexDataType` — Тип данных индекса выводится
`int32` (значение по умолчанию) | `int8` | `int16` | `uint8` | `uint16` | `uint32`

Задайте тип данных индекса выход от объекта как: int8uint8int16uint16int32uint32.

Свойства фиксированной точки

`RoundingMethod` — Округление метода для операций фиксированной точки
`'Floor'` (значение по умолчанию) | `'Ceiling'` | `'Convergent'` | `'Nearest'` | `'Round'` | `'Simplest'` | `'Zero'`

Задайте метод округления.

`OverflowAction` — Действие переполнения для операций фиксированной точки
`'Wrap'` (значение по умолчанию) | `'Saturate'`

Задайте действие переполнения.

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

Синтаксис

index = sqenc(input)

[index] = sqenc(input,bpoints)

[index] = sqenc(input,bpoints,cBook)

[index,codeword] = sqenc(___)

[___,qerr] = sqenc(___)

[___,cStatus] = sqenc(___)

Описание

пример

index = sqenc(input) возвращает index из области квантования, к который input принадлежит. Входные данные, граничные точки, значения книги шифров, квантовали выходные значения, и ошибка квантования должна иметь совпадающий тип данных каждый раз, когда они присутствуют.

[index] = sqenc(input,bpoints) вход bpoints использования как граничные точки, когда BoundaryPointsSource свойством является Input port.

[index] = sqenc(input,bpoints,cBook) вход bpoints использования как граничные точки и вход cBook как книга шифров, когда BoundaryPointsSource свойством является 'Input port' и любой CodewordOutputPort свойство или QuantizationErrorOutputPort свойством является true.

[index,codeword] = sqenc(___) выводит codeword значения, который соответствует каждому значению индекса когда CodewordOutputPort свойством является true.

[___,qerr] = sqenc(___) выводит ошибку квантования qerr для каждого входного значения, когда QuantizationErrorOutputPort свойством является true.

[___,cStatus] = sqenc(___) также возвращает выход cStatus как выходной порт состояния усечения для каждого входного значения, когда Partitioning свойством является 'Bounded' и ClippingStatusOutputPort свойством является true. Если входное значение вне области значений, заданной BoundaryPoints свойство, cStatus true. Если входное значение в области значений, cStatus false.

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

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

`input` — Входные данные
вектор | матрица

Входные данные, заданные как вектор или матрица. Если вход является фиксированной точкой, это должна быть подписанная фиксированная точка с наклоном степени двойки и нулевым смещением.

Типы данных: single | double | int8 | int16 | int32 | int64 | fi

`bpoints` — Граничные точки
вектор

Граничные точки областей квантизатора, заданных как вектор. Векторные значения должны быть в порядке возрастания. Позвольте [p0 p1 p2 p3 ... pN] обозначьте граничные точки в квантизаторе. Если квантизатор ограничен, объект использует этот вход, чтобы задать [p0 p1 p2 p3 ... pN]. Если квантизатор неограничен, объект использует этот вход, чтобы задать [p1 p2 p3 ... p(N-1)] и наборы p0 = -Inf и pN = +Inf.

Зависимости

Этот вход применяется, когда вы устанавливаете BoundaryPointsSource свойство к Input port.

`cBook` — Сборник кодов
вектор

Книга шифров, заданная как вектор квантованных выходных значений, которые соответствуют каждой области. Если Partitioning свойством является 'Bounded' и вектор граничных точек имеет длину N, этот вход должен быть вектором длины N-1. Если Partitioning свойством является 'Unbounded' и вектор граничных точек имеет длину N, этот вход должен быть вектором длины N +1.

Зависимости

Этот вход применяется, когда вы устанавливаете BoundaryPointsSource свойством является 'Input port' и любой CodewordOutputPort свойство или QuantizationErrorOutputPort свойством является true.

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

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

`index` — Индекс области квантования
вектор | матрица

Индекс области квантования, к который input принадлежит, возвращенный как вектор или матрица одного размера с input.

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

`codeword` — Значения кодовой комбинации
вектор | матрица

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

Зависимости

Этот выход доступен когда CodewordOutputPort свойство установлено в true.

Типы данных: single | double | int8 | int16 | int32 | int64 | fi

`qerr` — Ошибка квантования
вектор | матрица

Ошибка квантования для каждого входного значения, возвращенного как вектор или матрица одного размера с input.

Зависимости

Этот выход доступен когда QuantizationErrorOutputPort свойство установлено в true.

Типы данных: single | double | int8 | int16 | int32 | int64 | fi

`cStatus` — Состояние Clipping
вектор | матрица

Состояние Clipping для каждого входного значения, возвращенного как вектор или матрица. Если входное значение вне области значений, заданной BoundaryPoints свойство, cStatus true. Если входное значение в области значений, cStatus false.

Зависимости

Этот выход доступен когда Partitioning свойством является 'Bounded' и ClippingStatusOutputPort свойство установлено в true.

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

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

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

release(obj)

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

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

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

Примеры

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

Квантуйте различные дробные входные параметры

Скрипт Open Live Script

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

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

sqenc = dsp.ScalarQuantizerEncoder;
sqenc.BoundaryPoints = [-.001 .499 1.499 ...
    2.499 3.499 4.499 5.001];
sqenc.CodewordOutputPort = true;
sqenc.Codebook = [0 1 2 3 4 5];
input = (0:0.02:5)';
[index, quantizedValue] = sqenc(input);
plot(1:length(input), [input quantizedValue]);

Алгоритмы

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

Расширенные возможности

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Указания и ограничения по применению:

Смотрите системные объекты в Генерации кода MATLAB (MATLAB Coder).

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

dsp.ScalarQuantizerEncoder

Описание

Создание

Синтаксис

Описание

Свойства

BoundaryPointsSource — Источник граничных точек 'Property' (значение по умолчанию) | 'Input port'

Partitioning — Квантизатор ограничен или неограничен 'Bounded' (значение по умолчанию) | 'Unbounded'

BoundaryPoints — Граничные точки областей квантизатора1:10 (значение по умолчанию) | вектор

Зависимости

SearchMethod — Найдите индекс квантизатора линейным или двоичным поиском 'Linear' (значение по умолчанию) | 'Binary'

TiebreakerRule — Поведение, когда введенный равняется граничной точке 'Choose the lower index' (значение по умолчанию) | 'Choose the higher index'

CodewordOutputPort — Включите выход значения кодовой комбинации false (значение по умолчанию) | true

QuantizationErrorOutputPort — Включите выход ошибки квантования false (значение по умолчанию) | true

Codebook — Книга шифров1.5:9.5 (значение по умолчанию) | вектор

Зависимости

ClippingStatusOutputPort — Включите выход усечения состояния false (значение по умолчанию) | true

Зависимости

OutputIndexDataType — Тип данных индекса выводится int32 (значение по умолчанию) | int8 | int16 | uint8 | uint16 | uint32

Свойства фиксированной точки

RoundingMethod — Округление метода для операций фиксированной точки 'Floor' (значение по умолчанию) | 'Ceiling' | 'Convergent' | 'Nearest' | 'Round' | 'Simplest' | 'Zero'

OverflowAction — Действие переполнения для операций фиксированной точки 'Wrap' (значение по умолчанию) | 'Saturate'

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

Синтаксис

Описание

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

input — Входные данные вектор | матрица

bpoints — Граничные точки вектор

Зависимости

cBook — Сборник кодов вектор

Зависимости

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

index — Индекс области квантования вектор | матрица

codeword — Значения кодовой комбинации вектор | матрица

Зависимости

qerr — Ошибка квантования вектор | матрица

Зависимости

cStatus — Состояние Clipping вектор | матрица

Зависимости

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

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

Примеры

Квантуйте различные дробные входные параметры

Алгоритмы

Расширенные возможности

Генерация кода C/C++ Генерация кода C и C++ с помощью MATLAB® Coder™.

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

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

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

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

Поддержка

`BoundaryPointsSource` — Источник граничных точек
`'Property'` (значение по умолчанию) | `'Input port'`

`Partitioning` — Квантизатор ограничен или неограничен
`'Bounded'` (значение по умолчанию) | `'Unbounded'`

`BoundaryPoints` — Граничные точки областей квантизатора
1:10 (значение по умолчанию) | вектор

`SearchMethod` — Найдите индекс квантизатора линейным или двоичным поиском
`'Linear'` (значение по умолчанию) | `'Binary'`

`TiebreakerRule` — Поведение, когда введенный равняется граничной точке
`'Choose the lower index'` (значение по умолчанию) | `'Choose the higher index'`

`CodewordOutputPort` — Включите выход значения кодовой комбинации
`false` (значение по умолчанию) | `true`

`QuantizationErrorOutputPort` — Включите выход ошибки квантования
`false` (значение по умолчанию) | `true`

`Codebook` — Книга шифров
1.5:9.5 (значение по умолчанию) | вектор

`ClippingStatusOutputPort` — Включите выход усечения состояния
`false` (значение по умолчанию) | `true`

`OutputIndexDataType` — Тип данных индекса выводится
`int32` (значение по умолчанию) | `int8` | `int16` | `uint8` | `uint16` | `uint32`

`RoundingMethod` — Округление метода для операций фиксированной точки
`'Floor'` (значение по умолчанию) | `'Ceiling'` | `'Convergent'` | `'Nearest'` | `'Round'` | `'Simplest'` | `'Zero'`

`OverflowAction` — Действие переполнения для операций фиксированной точки
`'Wrap'` (значение по умолчанию) | `'Saturate'`

`input` — Входные данные
вектор | матрица

`bpoints` — Граничные точки
вектор

`cBook` — Сборник кодов
вектор

`index` — Индекс области квантования
вектор | матрица

`codeword` — Значения кодовой комбинации
вектор | матрица

`qerr` — Ошибка квантования
вектор | матрица

`cStatus` — Состояние Clipping
вектор | матрица

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.