zeros

Creare array di tutti zeri

Sintassi

X = zeros

X = zeros(n)

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

X = zeros(sz)

X = zeros(___,typename)

X = zeros(___,like=p)

Descrizione

X = zeros restituisce lo scalare 0.

X = zeros(n) restituisce una matrice di zeri n x n.

X = zeros(sz1,...,szN) restituisce un array sz1 x...x szN di zeri dove sz1,...,szN indica la grandezza di ciascuna dimensione. Ad esempio, zeros(2,3) restituisce una matrice 2x3.

X = zeros(sz) restituisce un array di zeri dove il vettore di dimensione sz definisce size(X). Ad esempio, zeros([2 3]) restituisce una matrice 2x3.

X = zeros(___,typename) restituisce un array di zeri del tipo di dati typename. Ad esempio, zeros("int8") restituisce uno 0 scalare intero a 8 bit. È possibile utilizzare uno qualsiasi degli argomenti di input nelle sintassi precedenti.

X = zeros(___,like=p) restituisce un array di zeri come p; ossia, dello stesso tipo di dati (classe), sparsità e complessità (reale o complessa) di p. È possibile specificare typename o like, ma non entrambi.

Esempi

Matrice di zeri

Creare una matrice di zeri 4x4.

X = zeros(4)

X = 4×4

     0     0     0     0
     0     0     0     0
     0     0     0     0
     0     0     0     0

Array tridimensionale di zeri

Creare un array di zeri 2x3x4.

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

ans = 1×3

     2     3     4

Riproduzione della dimensione da un array esistente

Creare un array di zeri della stessa dimensione di un array esistente.

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

X = 3×2

     0     0
     0     0
     0     0

È prassi comune combinare le due righe di codice precedenti in un'unica riga:

X = zeros(size(A));

Specifica del tipo di dati degli zeri

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

X = zeros(1,3,"uint32")

X = 1×3 uint32 row vector

   0   0   0

class(X)

ans = 
'uint32'

Riproduzione della complessità da un array esistente

Creare uno scalare 0 che sia complesso come un array esistente anziché a valore reale.

Creare prima un vettore complesso.

p = [1+2i 3i];

Creare uno scalare 0 che sia complesso come p.

X = zeros(like=p)

X = 
0.0000 + 0.0000i

Riproduzione della sparsità da un array esistente

Creare una matrice sparsa 10x10.

p = sparse(10,10,pi);

Creare una matrice di zeri 2x3 che sia sparsa come p.

X = zeros(2,3,like=p)

X = 2×3 sparse double matrix
   All zero

Riproduzione della dimensione e del tipo di dati da un array esistente

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

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

Creare un array di zeri che abbia la stessa dimensione e tipo di dati di p.

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

X = 2×3 uint8 matrix

   0   0   0
   0   0   0

class(X)

ans = 
'uint8'

Riproduzione di array distribuiti

Se si dispone di Parallel Computing Toolbox™, creare un array distribuito di zeri 1000x1000 con tipo di dati sottostante int8. Per il tipo di dati distributed, la sintassi like riproduce il tipo di dati sottostante oltre al tipo di dati primario.

p = zeros(1000,"int8","distributed");

Starting parallel pool (parpool) using the 'local' profile ...
connected to 6 workers.

Creare un array di zeri che abbia la stessa dimensione, lo stesso tipo di dati primari e lo stesso tipo di dati sottostanti di p.

X = zeros(size(p),like=p);
class(X)

ans =

    'distributed'

underlyingType(X)

ans =

    'int8'

Argomenti di input

n — Dimensione della matrice quadrata

valore intero

Dimensione della matrice quadrata, specificata come valore intero.

• 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 (come argomenti separati)

valori interi

Grandezza di ciascuna dimensione, specificata come argomenti separati di valori interi.

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

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

• Oltre la seconda dimensione, zeros ignora le dimensioni finali con grandezza pari a 1. Ad esempio, zeros(3,1,1,1) produce un vettore di zeri 3x1.

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

sz — Grandezza di ciascuna dimensione (come un vettore riga)

valori interi

Grandezza di ciascuna dimensione, 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.

• Oltre la seconda dimensione, zeros ignora le dimensioni finali con grandezza pari a 1. Ad esempio, zeros([3 1 1 1]) produce un vettore di zeri 3x1.

Esempio sz = [2 3 4] crea un array 2x3x4.

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

typename — Tipo di dati (classe) da creare

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

Tipo di dati (classe) da creare, specificato come "double", "single", "logical","int8", "uint8", "int16", "uint16", "int32", "uint32", "int64", "uint64" o il nome di un’altra classe che fornisce supporto zeros.

p — Prototipo di array da creare

array

Prototipo di array da creare, specificato come array.

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

Argomenti di output

X — Array di zeri

scalare | vettore | matrice | array multidimensionale

Array di zeri, restituito 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 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 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 zeros 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 = zeros(3,datatype,'gpuArray') crea un array di zeri di GPU 3x3 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 = zeros(3,datatype,'distributed') crea una matrice distribuita di zeri 3x3 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 zeros (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 | ones | rand | createArray | complex | false | size

Argomenti

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