complex

Crear un arreglo complejo

Sintaxis

z = complex(a,b)

z = complex(x)

Descripción

z = complex(a,b) crea una salida compleja, z, a partir de dos entradas reales, de forma que z = a + bi.

La función complex proporciona un sustituto útil para expresiones, como a + 1i*b o a + 1j*b, cuando

• a y b no son double ni single

• b es todo ceros

z = complex(x) devuelve el equivalente complejo de x, de forma que isreal(z) devuelve 0 (false) lógico.

• Si x es real, z es x + 0i.

• Si x es complejo, z es idéntico a x.

Ejemplos

Escalar complejo a partir de dos escalares reales

Use la función complex para crear el escalar complejo, 3 + 4i.

z = complex(3,4)

z = 
3.0000 + 4.0000i

Vector complejo a partir de dos vectores reales

Cree un vector uint8 complejo a partir de dos vectores uint8 reales. El tamaño de z, 4 por 1, es igual que el tamaño de los argumentos de entrada.

a = uint8([1;2;3;4]);
b = uint8([2;2;7;7]);

z = complex(a,b)

z = 4×1 uint8 column vector

   1 +   2i
   2 +   2i
   3 +   7i
   4 +   7i

Escalar complejo a partir de un escalar real

Cree un escalar complejo con parte imaginaria cero.

z = complex(12)

z = 
12.0000 + 0.0000i

Verifique que z es complejo.

isreal(z)

ans = logical
   0

Argumentos de entrada

a — Componente real

escalar | vector | matriz | arreglo multidimensional

Componente real, especificado como escalar, vector, matriz o arreglo multidimensional.

El tamaño de a debe coincidir con el tamaño de b, a menos que uno sea un escalar. Si a o b es un escalar, MATLAB^® expande el escalar para que coincida con el tamaño de la otra entrada.

a y b pueden tener diferentes tipos de datos. No obstante, si a o b es un tipo de datos de valores enteros, la otra entrada debe tener el mismo tipo de enteros o ser un escalar doble (no disperso).

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

b — Componente imaginario

escalar | vector | matriz | arreglo multidimensional

Componente imaginario, especificado como escalar, vector, matriz o arreglo multidimensional.

El tamaño de b debe coincidir con el tamaño de a, a menos que uno sea un escalar. Si a o b es un escalar, MATLAB expande el escalar para que coincida con el tamaño de la otra entrada.

a y b pueden tener diferentes tipos de datos. No obstante, si a o b es un tipo de datos de valores enteros, la otra entrada debe tener el mismo tipo de enteros o ser un escalar doble (no disperso).

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

x — Arreglo de entrada

escalar | vector | matriz | arreglo multidimensional

Arreglo de entrada, especificado como escalar, vector, matriz o arreglo multidimensional.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical
Soporte de números complejos: Sí

Argumentos de salida

z — Arreglo complejo

escalar | vector | matriz | arreglo multidimensional

Arreglo complejo, devuelto como escalar, vector, matriz o arreglo multidimensional.

El tamaño de z es el mismo que el de los argumentos de entrada.

A continuación, se describe el tipo de datos de z cuando a y b tienen diferentes tipos de datos.

• Si a o b son single, z es single.

• Si a o b son logical, z es el tipo de datos de la entrada no lógica.

• Si a o b es un tipo de datos de valores enteros, z es el mismo tipo de datos de valores enteros.

Además, z solo es disperso cuando ambos argumentos de entrada a y b son dispersos.

Sugerencias

• Si b solo contiene ceros, z es complejo y el valor de todos sus componentes imaginarios es 0. En contraste, la suma a + 0i devuelve un resultado estrictamente real.

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

La función complex es totalmente compatible con los arreglos altos. Para obtener más información, consulte Arreglos altos.

Generación de código C/C++
Genere código C y C++ mediante MATLAB® Coder™.

Generación de código de GPU
Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Generación de código HDL
Genere código VHDL, Verilog y SystemVerilog para diseños FPGA y ASIC mediante HDL Coder™.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función complex es totalmente compatible con los arreglos de GPU. Para ejecutar la función en una GPU, especifique los datos de entrada como un gpuArray (Parallel Computing Toolbox). Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

Consulte también

abs | angle | conj | i | imag | isreal | j | real

Temas

• Crear números complejos