ones

Creare array di tutti numeri uno

Sintassi

X = ones

X = ones(n)

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

X = ones(sz)

X = ones(___,typename)

X = ones(___,like=p)

Descrizione

X = ones restituisce lo scalare 1.

X = ones(n) restituisce una matrice n x n di numeri uno.

X = ones(sz1,...,szN) restituisce un array sz1 x...x szN di numeri uno dove sz1,...,szN indica la grandezza di ciascuna dimensione. Ad esempio, ones(2,3) restituisce un array 2x3 di numeri uno.

X = ones(sz) restituisce un array di numeri uno dove il vettore di grandezza sz definisce size(X). Ad esempio, ones([2,3]) restituisce un array 2x3 di numeri uno.

X = ones(___,typename) specifica inoltre il tipo di dati (classe) di X per qualsiasi sintassi precedente. Ad esempio, ones(5,"int8") restituisce una matrice 5x5 di numeri interi a 8 bit.

X = ones(___,like=p) specifica che X ha lo stesso tipo di dati, sparsità e complessità (reale o complessa) della variabile numerica p.

Esempi

Array quadrato di numeri uno

Creare un array 4x4 di numeri uno.

X = ones(4)

X = 4×4

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

Array tridimensionale di numeri uno

Creare un array 2x3x4 di numeri uno.

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

ans = 1×3

     2     3     4

Grandezza definita dall'array esistente

Definire un array A di 3x2.

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

sz = 1×2

     3     2

Creare un array di numeri uno che abbia la stessa grandezza di A.

X = ones(sz)

X = 3×2

     1     1
     1     1
     1     1

Tipi di dati numerici non predefiniti

Creare un vettore 1x3 di numeri uno i cui elementi sono numeri interi senza segno a 16 bit.

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

X = 1×3 uint16 row vector

   1   1   1

class(X)

ans = 
'uint16'

Uno complesso

Crea uno scalare 1 che non ha valore reale, ma è complesso come un array esistente.

Definire un vettore complesso.

p = [1+2i 3i];

Creare uno scalare 1 che sia complesso come p.

X = ones(like=p)

X = 
1.0000 + 0.0000i

Grandezza e tipo di dati numerici definiti dall'array esistente

Definire un array 2x3 di numeri interi senza segno a 8 bit.

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

Creare un array di numeri uno che abbia la stessa grandezza e lo stesso tipo di dati di p.

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

X = 2×3 uint8 matrix

   1   1   1
   1   1   1

class(X)

ans = 
'uint8'

Argomenti di input

n — Dimensione della matrice quadrata

valore intero

La dimensione della matrice quadrata, specificata come valore intero, definisce l'output come una matrice quadrata n x n di numeri uno.

• Se n è 0, X è una matrice vuota.

• Se n è negativo, viene trattato come 0.

Tipi di dati: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz1,...,szN — Grandezza di ciascuna dimensione

due o più valori interi

La grandezza di ciascuna dimensione, specificata come due o più valori interi, definisce X come un array sz1 x...x -szN.

• Se la grandezza di qualsiasi dimensione è 0, X è un array vuoto.

• Se la grandezza di qualsiasi dimensione è negativa, viene trattata come 0.

• Se una qualsiasi dimensione finale superiore a 2 ha una grandezza pari a 1, l'output X non include tali dimensioni.

Tipi di dati: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — Grandezza dell'output

vettore riga di valori interi

Grandezza dell'output, specificata come vettore riga di valori interi. Ciascun elemento di questo vettore indica la grandezza della dimensione corrispondente.

• Se la grandezza di qualsiasi dimensione è 0, X è un array vuoto.

• Se la grandezza di qualsiasi dimensione è negativa, viene trattata come 0.

• Se una qualsiasi dimensione finale superiore a 2 ha una grandezza pari a 1, l'output X non include tali dimensioni.

Esempio sz = [2 3 4] definisce X come un array 2x3x4.

Tipi di dati: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

typename — Classe di output

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

Classe di output, specificata come "double", "single", "logical", "int8", "uint8", "int16", "uint16", "int32", "uint32", "int64" o "uint64".

p — Prototipo

variabile

Prototipo, specificato come variabile.

Tipi di dati: double | single | logical | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Supporto numeri complessi: Sì

Argomenti di output

X — Array di uni

scalare | vettore | matrice | array multidimensionale

Array di uni, specificato come scalare, vettore, matrice o array multidimensionale.

Funzionalità estese

Generazione di codice C/C++

Genera codice C e C++ con MATLAB® Coder™.

Note su utilizzo e limitazioni:

• Le dimensioni devono essere numeri interi reali e non negativi. Le dimensioni vuote non sono supportate.

Generazione di codice GPU

Genera codice CUDA® per GPU NVIDIA® con GPU Coder™.

Note su utilizzo e limitazioni:

Consultare le note su utilizzo e limitazioni nella sezione Generazione di codice C/C++. Le stesse limitazioni si applicano alla generazione di codice GPU.

Generazione di codice HDL

Genera codice VHDL, Verilog e SystemVerilog per progetti FPGA e ASIC utilizzando HDL Coder™.

Le dimensioni devono essere numeri interi reali e non negativi.

Ambiente basato su thread

Esegui il codice in background usando MATLAB® backgroundPool oppure accelera il codice con Parallel Computing Toolbox™ ThreadPool.

Questa funzione supporta completamente gli ambienti basati su thread. Per maggiori informazioni, vedere Run MATLAB Functions in Thread-Based Environment.

Array GPU

Accelera il codice mediante esecuzione su un’unità di elaborazione grafica (GPU) con Parallel Computing Toolbox™.

La funzione ones supporta l'input di array GPU con queste note su utilizzo e limitazioni:

• È possibile specificare typename come 'gpuArray'. Se typename è specificato come 'gpuArray', il tipo sottostante predefinito dell'array è double.

  Per creare un array di GPU con tipo sottostante datatype, specificare il tipo sottostante come ulteriore argomento prima di typename. Ad esempio, X = ones(3,datatype,'gpuArray') crea un array GPU 3x3 di numeri uno con tipo sottostante datatype.

  È possibile specificare il tipo sottostante datatype come una di queste opzioni:

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• È inoltre possibile specificare la variabile numerica p come un gpuArray.

  Se p specificato come un gpuArray, il tipo sottostante dell’array restituito è lo stesso di p.

Per maggiori informazioni, vedere Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Array distribuiti

Partiziona array di grandi dimensioni nella memoria combinata del cluster con Parallel Computing Toolbox™.

Note su utilizzo e limitazioni:

• È possibile specificare typename come 'codistributed' o 'distributed'. Se typename è specificato come 'codistributed' o 'distributed', il tipo sottostante predefinito dell'array restituito è double.

  Per creare un array distribuito o co-distribuito con tipo sottostante datatype, specificare il tipo sottostante come ulteriore argomento prima di typename. Ad esempio, X = ones(3,datatype,'distributed') crea una matrice distribuita 3x3 di numeri uno con tipo sottostante datatype.

  È possibile specificare il tipo sottostante datatype come una di queste opzioni:

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• È inoltre possibile specificare p come un array codistributed o distributed.

  Se p è specificato come un array codistributed o distributed, il tipo sottostante dell'array restituito è lo stesso di p.

• Per ulteriori sintassi codistributed, vedere ones (codistributed) (Parallel Computing Toolbox).

Per maggiori informazioni, vedere Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Cronologia versioni

Introduzione prima di R2006a

Vedi anche

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

Argomenti

• Class Support for Array-Creation Functions
• Pre-allocazione