La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

uencode

Cuantificar y codificar entradas de coma flotante como salidas de enteros

Sintaxis

y = uencode(x,n)

y = uencode(x,n,v)

y = uencode(x,n,v,outputSign)

Descripción

y = uencode(x,n) cuantifica las entradas en un arreglo multidimensional de números de punto flotante x en el intervalo [-1, 1] y las codifica como enteros utilizando la cuantificación de nivel 2ⁿ. Los elementos de la salida y son enteros sin signo con magnitudes en el intervalo [0, 2ⁿ – 1].

y = uencode(x,n,v) permite que la entrada x tenga entradas con valores de punto flotante en el intervalo [-v,v] antes de saturarlas.

y = uencode(x,n,v,outputSign) especifica la opción outputSign para generar salidas enteras con signo o sin signo.

Ejemplos

Asignar escalares de coma flotante a enteros

Asigne escalares de coma flotante en [-1, 1] a enteros uint8 (sin signo). Represente una gráfica en escalera. El eje horizontal tiene rango desde -1 hasta 1 y el eje vertical desde 0 hasta 7 (es decir, $$2^3-1$$).

u = -1:0.01:1;
y = uencode(u,3);
plot(u,y,'.')

Vea los efectos de saturación cuando especifica un valor inferior para el pico en la entrada.

u = -2:0.5:2;
y = uencode(u,5,1)

y = 1×9 uint8 row vector

    0    0    0    8   16   24   31   31   31

Especifique que desea una salida con signo.

u = -2:0.5:2;
y = uencode(u,5,2,'signed')

y = 1×9 int8 row vector

   -16   -12    -8    -4     0     4     8    12    15

Argumentos de entrada

x — Entradas de punto flotante

vector | matriz | arreglo multidimensional

Entradas de punto flotante, especificadas como un vector, una matriz o un arreglo multidimensional. La función uencode trata los elementos de x fuera del intervalo [-v, v] como desbordamientos y los satura de la manera siguiente:

• Para los elementos de entrada menores que -v, uencode devuelve un valor de salida de 0 (salida sin signo) o -2^n/2 (salida con signo).

• Para los elementos de entrada mayores que v, uencode devuelve un valor de salida de 2^n-1 (salida sin signo) o 2^n/2-1 (salida con signo).

La función uencode codifica los componentes real e imaginario de entradas de valor complejo x de forma independiente.

Tipos de datos: single | double
Soporte de números complejos: Sí

n — Medida del número de niveles de cuantificación

escalar entero positivo

Medida del número de niveles de cuantificación, especificada como un escalar entero positivo. n debe ser un entero entre 2 y 32 (incluidos). El valor de 2ⁿ indica el número de niveles de cuantificación establecidos para el arreglo cuantificado y, y define un rango de cuantificación para y.

El rango de cuantificación depende del valor de n y la naturaleza del signo de y:

• Entradas con signo: de -2ⁿ/2 a (2ⁿ/2)–1.

• Entradas sin signo: de 0 a (2ⁿ–1).

v — Amplitud de no saturación

1 (predeterminado) | escalar positivo

Amplitud de no saturación, especificada como un escalar positivo. La función trata los elementos de x fuera del intervalo [-v,v] como saturación y los codifica de la manera siguiente:

• Para los elementos de entrada menores que -v, uencode devuelve un valor de salida de 0 (salida sin signo) o -2^n/2 (salida con signo).

• Para los elementos de entrada mayores que v, uencode devuelve un valor de salida de 2^n-1 (salida sin signo) o 2^n/2-1 (salida con signo).

outputSign — Signo de la salida

"unsigned" (predeterminado) | "signed"

Signo de la salida, especificado como "unsigned" o "signed". El tipo de entero de la salida depende del número de niveles de cuantificación 2ⁿ y del valor de outputSign, que puede ser uno de los siguientes:

• "signed": las salidas son enteros con signo, con magnitudes en el intervalo [–2ⁿ/2, (2ⁿ/2) – 1].

• "unsigned": Las salidas son enteros sin signo, con magnitudes en el intervalo [0, 2ⁿ – 1].

Argumentos de salida

y — Salidas de enteros codificados

vector | matriz | arreglo multidimensional

Salidas de enteros codificados, devueltas como un vector, una matriz o un arreglo multidimensional. El arreglo de salida y tiene la misma dimensión que x.

Algoritmos

La función uencode asigna el valor de entrada de coma flotante a un valor entero determinado por el requisito de 2ⁿ niveles de cuantificación. Esta codificación se ajusta a la definición de codificación uniforme especificada en la Recomendación UIT-T G.701. El rango de entrada [-v,v] se divide en 2ⁿ intervalos uniformemente espaciados. Las entradas del rango [-v,v] se cuantifican primero según esta subdivisión del rango de entrada y luego se asignan a uno de los 2ⁿ enteros. El rango de la salida depende de si especifica que desea enteros con signo.

La función optimiza los tipos de datos de salida para el número de bits, como se muestra en esta tabla.

n	Entero sin signo	Entero con signo
2 a 8	uint8	int8
9 a 16	uint16	int16
17 a 32	uint32	int32

Referencias

[1] International Telecommunication Union. General Aspects of Digital Transmission Systems: Vocabulary of Digital Transmission and Multiplexing, and Pulse Code Modulation (PCM) Terms. ITU-T Recommendation G.701. March, 1993.

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• La entrada n debe ser una constante en tiempo de compilación.

• Los argumentos opcionales deben ser constantes en tiempo de compilación.

Historial de versiones

Introducido antes de R2006a

R2022b: Generar código C y C++

La función uencode admite la generación de código C/C++.

Consulte también

udecode