fixed.Quantizer

Квантуйте номера с фиксированной точкой

Синтаксис

q = fixed.Quantizer
q = fixed.Quantizer(nt,rm,oa)
q = fixed.Quantizer(s,wl,fl,rm,oa)
q = fixed.Quantizer(Name,Value)

Описание

q = fixed.Quantizer создает квантователь q который квантует фиксированную точку (fi) номера с использованием настроек фиксированной точки по умолчанию.

q = fixed.Quantizer(nt,rm,oa) использует numerictype (nt) информацию об объекте и RoundingMethod (rm) и OverflowAction (oa) свойства.

numerictype, метод округления и действие переполнения применяются только во время квантования. Получившиеся квантованные q не имеет никакого fimath, прикрепленного к нему.

q = fixed.Quantizer(s,wl,fl,rm,oa) использует Signed (s), WordLength (wl), FractionLength (fl), RoundingMethod (rm), и OverflowAction (oa) свойства.

q = fixed.Quantizer(Name,Value) создает квантователь с опциями свойств, заданными одним или несколькими Name,Value аргументы в виде пар. Вы разделяете пары Name,Value аргументы с запятыми. Name - имя аргумента, и Value - соответствующее значение. Name должны находиться внутри одинарных кавычек (''). Можно задать несколько аргументы пары "имя-значение" в любом порядке как Name1,Value1,…,NameN,ValueN.

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

nt

Объект численного типа с двоичной точкой или масштабированный объект числового типа с уклоном-смещением с фиксированной точкой. Если ваш fixed.Quantizer использует объект числового типа, который имеет либо Signedness от Auto или неопределенные Scaling, возникает ошибка.

rm

Метод округления для применения к выходу данным. Допустимые методы округления: Ceiling, Convergent, Floor, Nearest, Round, и Zero. Связанное имя свойства RoundingMethod.

По умолчанию: Floor

oa

Переполнение действия, которое необходимо предпринять в случае переполнения данных. Допустимые действия переполнения Saturate и Wrap. Связанное имя свойства OverflowAction.

По умолчанию: Wrap

s

Логическое значение, true или false, что указывает, является ли выход подписанным или неподписанным, соответственно. Связанное имя свойства Signed.

По умолчанию: true

wl

Размер слова (количество бит) выходных данных. Связанное имя свойства WordLength.

По умолчанию: 16

fl

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

По умолчанию: 15

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

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

Bias

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

По умолчанию: 0

FixedExponent

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

Экспонента числа с фиксированной точкой равна отрицательной длине дроби. FixedExponent должно быть целым числом.

По умолчанию: -15

FractionLength

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

Это свойство автоматически переходит по умолчанию к максимально возможной точности на основе значения размера слова и значения реального мира fi объект.

По умолчанию: 15

OverflowAction

Действие, которое необходимо предпринять в случае переполнения данных. Допустимые действия переполнения Saturate и Wrap. .

По умолчанию: Wrap

RoundingMethod

Метод округления для применения к выходу данным. Допустимые методы округления: Ceiling, Convergent, Floor, Nearest, Round, и Zero.

По умолчанию: Floor

Signed

Является ли объект подписанным. Возможные значения этого свойства:

  • 1 - подпись

  • 0 - беззнаковый

  • true - подпись

  • false - беззнаковый

Примечание

Хотя и Signed свойство все еще поддерживается, Signedness свойство всегда появляется в numerictype отображение объекта. Если вы решите изменить или задать сигнальность своего numerictype объект с использованием Signed свойство, MATLAB® обновляет соответствующее значение Signedness свойство.

По умолчанию: true

Signedness

Является ли объект подписанным, неподписанным или имеет неопределенный знак. Возможные значения этого свойства:

  • Signed - подпись

  • Unsigned - беззнаковый

По умолчанию: Signed

Slope

Уклон, сопоставленный с объектом. Наклон является частью численного представления, используемого для выражения числа с фиксированной точкой. Наряду с смещением наклон образует масштабирование числа с фиксированной точкой.

По умолчанию: 2 ^ -15

SlopeAdjustmentFactor

Корректировка уклона, связанная с объектом. Корректировка наклона эквивалентна дробному наклону числа с фиксированной точкой. Дробный наклон является частью числового представления, используемого для выражения числа с фиксированной точкой.

SlopeAdjustmentFactor должно быть больше или равно 1 и меньше 2.

По умолчанию: 1

WordLength

Размер слова сохраненного целого значения объекта, в битах. Размер слова может быть любым положительным целым значением.

По умолчанию: 16

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

q

Квантователь, который квантует fi входных чисел

Примеры

Использовать fixed.Quantizer чтобы уменьшить размер слова, к которой приводит добавление двух чисел с фиксированной точкой.

q = fixed.Quantizer;
x1 = fi(0.1,1,16,15);
x2 = fi(0.8,1,16,15);
y  = quantize(q,x1+x2); 

Использовать fixed.Quantizer объект, чтобы изменить двоичную точку, масштабированную с фиксированной точкой fi, на наклонно-смещенную, масштабированную с фиксированной точкой fi

qsb = fixed.Quantizer(numerictype(1,7,1.6,0.2),...
  'Round','Saturate');
ysb = quantize(qsb,fi(pi,1,16,13));

Подробнее о

свернуть все

Номера с фиксированной точкой

Номера с фиксированной точкой могут быть представлены как

real-world value=(slope×stored integer)+bias

где наклон может быть выражен как

slope=fractional slope×2fixed exponent

Совет

  • Использование y = quantize(q,x) для квантования входного массива x использование настроек квантователя с фиксированной точкой q. x может быть любым числом fi с фиксированной точкой, кроме логического значения. Если x является масштабированным двойным, x и y данные будут одинаковыми, но y будет иметь параметры фиксированной точки. Если x является double или single, затем y = x. Эта функциональность позволяет вам совместно использовать один и тот же код как для типов данных с плавающей точкой, так и для объектов fi при наличии квантователей.

  • Использование n = numerictype(q) чтобы получить численный тип для текущих настроек квантователя q.

  • Использование clone(q) чтобы создать объект квантователя с теми же значениями свойств, что и q.

  • Если вы используете fixed.quantizer в генерации кода обратите внимание, что это указатель объекта и должно быть объявлено как постоянное.

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

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

.
Введенный в R2011b