ones

Crear un arreglo solo de unos

Sintaxis

X = ones

X = ones(n)

X = ones(sz1,...,szN)

X = ones(sz)

X = ones(___,typename)

X = ones(___,like=p)

Descripción

X = ones devuelve el escalar 1.

X = ones(n) devuelve una matriz de unos de n por n.

X = ones(sz1,...,szN) devuelve un arreglo de unos de sz1 por ... por szN en el que sz1,...,szN indica el tamaño de cada dimensión. Por ejemplo, ones(2,3) devuelve un arreglo de unos de 2 por 3.

X = ones(sz) devuelve un arreglo de unos en el que el vector de tamaño, sz, define size(X). Por ejemplo, ones([2,3]) devuelve un arreglo de unos de 2 por 3.

X = ones(___,typename) también especifica el tipo de datos (clase) de X para cualquiera de las sintaxis anteriores. Por ejemplo, ones(5,"int8") devuelve una matriz de 5 por 5 de enteros de 8 bits.

X = ones(___,like=p) especifica que X tiene el mismo tipo de datos, dispersión y complejidad (real o complejo) que la variable numérica p.

Ejemplos

Arreglo cuadrado de unos

Cree un arreglo de unos de 4 por 4.

X = ones(4)

X = 4×4

     1     1     1     1
     1     1     1     1
     1     1     1     1
     1     1     1     1

Arreglo 3D de unos

Cree un arreglo de unos de 2 por 3 por 4.

X = ones(2,3,4);
size(X)

ans = 1×3

     2     3     4

Tamaño definido por el arreglo existente

Defina un arreglo A de 3 por 2.

A = [1 4 ; 2 5 ; 3 6];
sz = size(A)

sz = 1×2

     3     2

Cree un arreglo de unos que tenga el mismo tamaño que A.

X = ones(sz)

X = 3×2

     1     1
     1     1
     1     1

Tipo de datos numéricos no predeterminado

Cree un vector de unos de 1 por 3 cuyos elementos sean enteros sin signo de 16 bits.

X = ones(1,3,"uint16")

X = 1×3 uint16 row vector

   1   1   1

class(X)

ans = 
'uint16'

Uno complejo

Cree un escalar 1 que no tenga valor real, sino que sea complejo como un arreglo existente.

Defina un vector complejo.

p = [1+2i 3i];

Cree un escalar 1 que sea complejo como p.

X = ones(like=p)

X = 
1.0000 + 0.0000i

Tamaño y tipo de datos numéricos definidos por un arreglo existente

Defina un arreglo de enteros sin signo de 8 bits de 2 por 3.

p = uint8([1 3 5; 2 4 6]);

Cree un arreglo de unos que tenga el mismo tamaño y tipo de datos que p.

X = ones(size(p),like=p)

X = 2×3 uint8 matrix

   1   1   1
   1   1   1

class(X)

ans = 
'uint8'

Argumentos de entrada

n — Tamaño de la matriz cuadrada

valor entero

El tamaño de la matriz cuadrada, especificado como valor entero, define la salida como una matriz cuadrada de unos de n por n.

• Si n es 0, X es una matriz vacía.

• Si n es negativo, se trata como 0.

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

sz1,...,szN — Tamaño de cada dimensión

dos o más valores enteros

El tamaño de cada dimensión, especificado como dos o más valores enteros, define X como un arreglo de sz1 por ... por szN.

• Si el tamaño de una dimensión cualquiera es 0, X es un arreglo vacío.

• Si el tamaño de una dimensión cualquiera es negativo, se trata como 0.

• Si alguna de las dimensiones finales mayores que 2 tienen un tamaño de 1, la salida, X, no incluye esas dimensiones.

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

sz — Tamaño de salida

vector fila de valores enteros

Tamaño de salida, especificado como vector fila de valores enteros. Cada elemento de este vector indica el tamaño de la dimensión correspondiente.

• Si el tamaño de una dimensión cualquiera es 0, X es un arreglo vacío.

• Si el tamaño de una dimensión cualquiera es negativo, se trata como 0.

• Si alguna de las dimensiones finales mayores que 2 tienen un tamaño de 1, la salida, X, no incluye esas dimensiones.

Ejemplo: sz = [2 3 4] define X como un arreglo de 2 por 3 por 4.

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

typename — Clase de salida

"double" (predeterminado) | "single" | "logical" | "int8" | "uint8" | ...

Clase de salida, especificada como "double", "single", "logical", "int8", "uint8", "int16", "uint16", "int32", "uint32", "int64" o "uint64".

p — Prototipo

variable

Prototipo, especificado como variable.

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

Argumentos de salida

X — Arreglo de unos

escalar | vector | matriz | arreglo multidimensional

Arreglo de unos, devuelto como un escalar, un vector, una matriz o un arreglo multidimensional.

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• Las dimensiones deben ser enteros reales no negativos. No se admiten dimensiones vacías.

Generación de código de GPU

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

Notas y limitaciones de uso:

Consulte las notas y limitaciones de uso en la sección de generación de código C/C++. Las mismas limitaciones son aplicables a la generación de código GPU.

Generación de código HDL

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

Las dimensiones deben ser enteros reales no negativos.

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 ones es compatible con entradas de arreglos de GPU con estas notas y limitaciones de uso:

• Puede especificar typename como 'gpuArray'. Si especifica typename como 'gpuArray', el tipo subyacente predeterminado del arreglo es double.

  Para crear un arreglo de GPU con el tipo subyacente datatype, especifique el tipo subyacente como argumento adicional antes de typename. Por ejemplo, X = ones(3,datatype,'gpuArray') crea un arreglo de GPU de unos de 3 por 3 con el tipo subyacente datatype.

  Puede especificar el tipo subyacente datatype como una de estas opciones:

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• También puede especificar la variable numérica p como gpuArray.

  Si especifica p como gpuArray, el tipo subyacente del arreglo devuelto es el mismo que p.

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™.

Notas y limitaciones de uso:

• Puede especificar typename como 'codistributed' o 'distributed'. Si especifica typename como 'codistributed' o 'distributed', el tipo subyacente predeterminado del arreglo devuelto es double.

  Para crear un arreglo distribuido o codistribuido con el tipo subyacente datatype, especifique el tipo subyacente como argumento adicional antes de typename. Por ejemplo, X = ones(3,datatype,'distributed') crea una matriz de unos distribuida de 3 por 3 con el tipo subyacente datatype.

  Puede especificar el tipo subyacente datatype como una de estas opciones:

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• También puede especificar p como arreglo codistributed o distributed.

  Si especifica p como arreglo codistributed o distributed, el tipo subyacente del arreglo devuelto es el mismo que p.

• Para ver sintaxis codistributed adicionales, consulte ones (codistributed) (Parallel Computing Toolbox).

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

eye | zeros | rand | randn | createArray | complex | false | size

Temas

• Class Support for Array-Creation Functions
• Preasignación