max

Elementi massimi dell'array

Sintassi

M = max(A)

M = max(A,[],"all")

M = max(A,[],dim)

M = max(A,[],vecdim)

M = max(A,[],___,missingflag)

[M,I] = max(___)

[M,I] = max(A,[],___,"linear")

C = max(A,B)

C = max(A,B,missingflag)

___ = max(___,"ComparisonMethod",method)

Descrizione

M = max(A) restituisce gli elementi massimi di un array.

• Se A è un vettore, max(A) restituisce il massimo di A.

• Se A è una matrice, max(A) è un vettore riga contenente il valore massimo di ciascuna colonna di A.

• Se A è un array multidimensionale, max(A) opera lungo la prima dimensione di A la cui grandezza non è uguale a 1, trattando gli elementi come vettori. La grandezza di M in questa dimensione diventa 1, mentre le grandezze di tutte le altre dimensioni rimangono le stesse come in A. Se A è un array vuoto la cui prima dimensione ha lunghezza pari a zero, M è un array vuoto con la stessa grandezza di A.

• Se A è una tabella o un orario, max(A) restituisce una tabella di una riga contenente il massimo di ciascuna variabile. (da R2023a)

M = max(A,[],"all") trova il massimo tra tutti gli elementi di A.

M = max(A,[],dim) restituisce l'elemento massimo lungo la dimensione dim. Ad esempio, se A è una matrice, max(A,[],2) restituisce un vettore colonna contenente il valore massimo di ciascuna riga.

M = max(A,[],vecdim) restituisce il valore massimo delle dimensioni specificate nel vettore vecdim. Ad esempio, se A è una matrice, max(A,[],[1 2]) restituisce il massimo su tutti gli elementi in A poiché ogni elemento di una matrice è contenuto nella porzione di array definita dalle dimensioni 1 e 2.

M = max(A,[],___,missingflag) specifica se omettere o includere i valori mancanti in A per una qualsiasi delle sintassi precedenti. Ad esempio, max(A,[],"includemissing") include tutti i valori mancanti nel calcolare il massimo. Per impostazione predefinita, max omette i valori mancanti.

[M,I] = max(___) restituisce inoltre l'indice nella dimensione operativa che corrisponde alla prima occorrenza del valore massimo di A.

[M,I] = max(A,[],___,"linear") restituisce inoltre l'indice lineare in A che corrisponde al valore massimo in A.

C = max(A,B) restituisce un array con gli elementi più grandi presi da A o B.

C = max(A,B,missingflag) specifica inoltre come trattare i valori mancanti.

___ = max(___,"ComparisonMethod",method) specifica opzionalmente come confrontare gli elementi per una qualsiasi delle sintassi precedenti. Ad esempio, per un vettore A = [-1 2 -9], la sintassi max(A,[],"ComparisonMethod","abs") confronta gli elementi di A in base ai loro valori assoluti e restituisce un valore massimo di -9.

Esempi

Elemento più grande del vettore

Creare un vettore e calcolare il suo elemento più grande.

A = [23 42 37 18 52];
M = max(A)

M = 
52

Elemento più grande del vettore complesso

Creare un vettore complesso e calcolare il suo elemento più grande, ossia l'elemento con la magnitudine più grande.

A = [-2+2i 4+i -1-3i];
max(A)

ans = 
4.0000 + 1.0000i

Elemento più grande in ciascuna colonna della matrice

Creare una matrice e calcolare l'elemento più grande in ciascuna colonna.

A = [2 8 4; 7 3 9]

A = 2×3

     2     8     4
     7     3     9

M = max(A)

M = 1×3

     7     8     9

Elemento più grande in ciascuna riga della matrice

Creare una matrice e calcolare l'elemento più grande in ciascuna riga.

A = [1.7 1.2 1.5; 1.3 1.6 1.99]

A = 2×3

    1.7000    1.2000    1.5000
    1.3000    1.6000    1.9900

M = max(A,[],2)

M = 2×1

    1.7000
    1.9900

Massimo della pagina dell'array

Creare un array tridimensionale e calcolare il massimo di ciascuna pagina di dati (righe e colonne).

A(:,:,1) = [2 4; -2 1];
A(:,:,2) = [9 13; -5 7];
A(:,:,3) = [4 4; 8 -3];
M1 = max(A,[],[1 2])

M1 = 
M1(:,:,1) =

     4


M1(:,:,2) =

    13


M1(:,:,3) =

     8

Per calcolare il massimo su tutte le dimensioni di un array, è possibile specificare ciascuna dimensione nell'argomento di dimensione del vettore oppure utilizzare l'opzione "all".

M2 = max(A,[],[1 2 3])

M2 = 
13

Mall = max(A,[],"all")

Mall = 
13

Elemento più grande inclusi i valori mancanti

Creare una matrice contenente valori NaN.

A = [1.77 -0.005 NaN -2.95; NaN 0.34 NaN 0.19]

A = 2×4

    1.7700   -0.0050       NaN   -2.9500
       NaN    0.3400       NaN    0.1900

Calcolare il valore massimo della matrice, includendo i valori mancanti. Per le colonne della matrice che contengono qualsiasi valore NaN, il massimo è NaN.

M = max(A,[],"includemissing")

M = 1×4

       NaN    0.3400       NaN    0.1900

Indici degli elementi più grandi

Creare una matrice A e calcolare gli elementi più grandi in ciascuna colonna, nonché gli indici delle righe di A in cui figurano.

A = [1 9 -2; 8 4 -5]

A = 2×3

     1     9    -2
     8     4    -5

[M,I] = max(A)

M = 1×3

     8     9    -2

I = 1×3

     2     1     1

Indici lineari di restituzione

Creare una matrice A e restituire il valore massimo di ciascuna riga della matrice M. Utilizzare l'opzione "linear" per restituire anche gli indici lineari I tali che M = A(I).

A = [1 2 3; 4 5 6]

A = 2×3

     1     2     3
     4     5     6

[M,I] = max(A,[],2,"linear")

M = 2×1

     3
     6

I = 2×1

     5
     6

maxvals = A(I)

maxvals = 2×1

     3
     6

Confronto dell'elemento più grande

Creare una matrice e restituire il valore più grande confrontando ciascuno dei suoi elementi con uno scalare.

A = [1 7 3; 6 2 9]

A = 2×3

     1     7     3
     6     2     9

B = 5;
C = max(A,B)

C = 2×3

     5     7     5
     6     5     9

Argomenti di input

A — Array di input

scalare | vettore | matrice | array multidimensionale | tabella | orario

Array di input, specificato come scalare, vettore, matrice, array multidimensionale, tabella o orario.

• Se A è complessa, max(A) restituisce il numero complesso con la magnitudine più grande. Se le magnitudini sono uguali, max(A) restituisce il valore con la magnitudine e l'angolo di fase più grandi.

• Se A è uno scalare, max(A) restituisce A.

• Se A è un array vuoto 0x0, lo è anche max(A).

Se A è di tipo categorical, deve essere un ordinale.

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

dim — Dimensione lungo la quale operare

scalare intero positivo

Dimensione lungo la quale operare, specificata come scalare intero positivo. Se non si specifica la dimensione, per impostazione predefinita si considera la prima dimensione dell'array la cui grandezza non è uguale a 1.

La dimensione dim indica la dimensione la cui lunghezza si riduce a 1. size(M,dim) è 1, mentre le grandezze di tutte le altre dimensioni rimangono invariate, a meno che size(A,dim) non sia 0. Se size(A,dim) è 0, max(A,dim) restituisce un array vuoto con la stessa grandezza di A.

Considerare una matrice di input m x n, A:

• max(A,[],1) calcola il massimo degli elementi in ciascuna colonna di A e restituisce un vettore riga 1 x n.

  

• max(A,[],2) calcola il massimo degli elementi in ciascuna riga di A e restituisce un vettore colonna m x 1.

  

vecdim — Vettore di dimensioni

vettore di numeri interi positivi

Vettore di dimensioni, specificato come vettore di numeri interi positivi. Ciascun elemento rappresenta una dimensione dell'array di input. Le lunghezze dell’output nelle dimensioni operative specificate sono 1, mentre le altre rimangono invariate.

Considerare un array di input 2x3x3, A. Quindi, max(A,[],[1 2]) restituisce un array 1x1x3 i cui elementi sono i massimi calcolati di ciascuna pagina di A.

B — Ulteriore array di input

scalare | vettore | matrice | array multidimensionale | tabella | orario

Ulteriore array di input, specificato come scalare, vettore, matrice, array multidimensionale, tabella o orario. Gli input A e B devono avere la stessa dimensione o dimensioni compatibili (ad esempio, A è una matrice M x N e B è uno scalare o un vettore riga di 1 x N). Per maggiori informazioni, vedere Grandezze di array compatibili per le operazioni di base.

• Se A e B sono entrambi degli array, devono essere dello stesso tipo di dato a meno che uno dei due non sia double. In tal caso, il tipo di dato dell'altro array può essere single, duration o qualsiasi tipo di numero intero.

• Se A e B sono array categorical ordinali, devono avere gli stessi insiemi di categorie con lo stesso ordine.

• Se A o B è una tabella o una orario, l'altro input può essere un array, una tabella o un orario.

Se B è di tipo categorical, deve essere un ordinale.

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

missingflag — Condizione di valore mancante

"omitmissing" (predefinito) | "omitnan" | "omitnat" | "omitundefined" | "includemissing" | "includenan" | "includenat" | "includeundefined"

Condizione di valore mancante, specificata come uno dei valori nella tabella sottostante.

Valore	Tipo di dati di input	Descrizione
"omitmissing"	Tutti i tipi di dati supportati	Ignora i valori mancanti negli array di input e calcola il massimo su un numero inferiore di punti. Se tutti gli elementi della dimensione operativa sono mancanti, manca anche l'elemento corrispondente in M.
"omitnan"	double, single, duration
"omitnat"	datetime
"omitundefined"	categorical
"includemissing"	Tutti i tipi di dati supportati	Includere i valori mancanti negli array di input durante il calcolo del massimo. Se un elemento qualsiasi della dimensione operativa è mancante, manca anche l'elemento corrispondente in M.
"includenan"	double, single, duration
"includenat"	datetime
"includeundefined"	categorical

method — Metodo di confronto

"auto" (predefinito) | "real" | "abs"

Metodo di confronto per l'input numerico, specificato come uno dei seguenti valori:

• "auto": per un array di input numerico A, confronta gli elementi in base a real(A) quando A è reale e in base a abs(A) quando A è complessa.

• "real": per un array di input numerico A, confronta gli elementi in base a real(A) quando A è reale o complessa. Se A presenta elementi con parti reali uguali, utilizzare imag(A) per interrompere le parità.

• "abs": per un array di input numerico A, confronta gli elementi in base a abs(A) quando A è reale o complessa. Se A presenta elementi con magnitudine uguale, utilizzare angle(A) nell'intervallo (-π,π] per interrompere le parità.

Argomenti di output

M — Valori massimi

scalare | vettore | matrice | array multidimensionale | tabella

Valori massimi, restituiti come scalare, vettore, matrice, array multidimensionale o tabella. size(M,dim) è 1, mentre le grandezze di tutte le altre dimensioni corrispondono alla grandezza della dimensione corrispondente in A, a meno che size(A,dim) non sia 0. Se size(A,dim) è 0, M è un array vuoto con la stessa grandezza di A.

I — Indice

scalare | vettore | matrice | array multidimensionale | tabella

Indice, restituito come scalare, vettore, matrice, array multidimensionale o tabella. I ha la stessa grandezza del primo output.

Quando "linear" non è specificato, I è l'indice nella dimensione operativa. Quando "linear" è specificato, I contiene gli indici lineari di A corrispondenti ai valori massimi.

Se l'elemento più grande compare più di una volta, I contiene l'indice della prima occorrenza del valore.

C — Elementi massimi da A o B

scalare | vettore | matrice | array multidimensionale | tabella | orario

Elementi massimi da A o B, restituiti come scalare, vettore, matrice, array multidimensionale, tabella o orario. La grandezza di C è determinata dall'espansione implicita delle dimensioni di A e B. Per maggiori informazioni, vedere Grandezze di array compatibili per le operazioni di base.

Il tipo di dato di C dipende dai tipi di dato di A e B:

• Se A e B sono dello stesso tipo di dato, C corrisponde al tipo di dato di A e B.

• Se A o B è single, C è single.

• Se A o B è un tipo di dato numero intero e l'altro è uno scalare double, C adotta il tipo di dato numero intero.

• Se A o B è una tabella o un orario, C è una tabella o un orario.

Funzionalità estese

Tall array

Esegui calcoli con array che hanno più righe di quelle allocabili in memoria.

La funzione max supporta i tall array con le seguenti note su utilizzo e limitazioni:

• L'output dell'indice non è supportato per gli input tabulari tall.

Per maggiori informazioni, vedere Tall Array.

Generazione di codice C/C++

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

Note su utilizzo e limitazioni:

• Per utilizzare un array vuoto come secondo argomento in fase di esecuzione, è necessario specificare un array di grandezza fissa 0x0 al momento della generazione di codice.

• Se utilizzati, gli argomenti dim, vecdim, missingflag e method devono essere costanti al momento della generazione di codice.

• Per l'argomento di input A:

  • Se non si specifica una dimensione, il generatore di codice opera lungo la prima dimensione dell'array di input che ha grandezza variabile o la cui grandezza non è uguale a 1. Se questa dimensione ha grandezza variabile al momento della generazione di codice ed è pari a 1 in fase di esecuzione, può verificarsi un errore di runtime. Per evitare il verificarsi di tale errore, specificare la dimensione.

  • Nel codice generato, l'array di input rimane complesso anche se tutti i suoi elementi hanno parti immaginarie pari a zero. In queste circostanze, i risultati prodotti dal codice generato potrebbero differire da quelli prodotti da MATLAB. Vedere Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder).

Generazione di codice GPU

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

Note su utilizzo e limitazioni:

• Per utilizzare un array vuoto come secondo argomento in fase di esecuzione, è necessario specificare un array di grandezza fissa 0x0 al momento della generazione di codice.

• Se utilizzati, gli argomenti dim, vecdim, missingflag e method devono essere costanti al momento della generazione di codice.

• Se non si specifica l'argomento dim, il generatore di codice opera lungo la prima dimensione di A che ha grandezza variabile o la cui grandezza non è uguale a 1.

• Se A è complessa e tutti gli elementi di A hanno parti immaginarie pari a zero, MATLAB^® potrebbe convertire A in real(A) prima di chiamare max(A). In questo caso, MATLAB confronta gli elementi in base a real(A), ma il codice generato confronta gli elementi in base a abs(A). Per fare in modo che il codice generato coincida con MATLAB, utilizzare max(real(A)) o max(A,'ComparisonMethod','real'). Vedere Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder).

Generazione di codice HDL

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

Note su utilizzo e limitazioni:

• Gli input di matrici tridimensionali o superiori non sono supportati.

• Gli input con tipi di dato complessi non sono supportati.

• Le matrici o i vettori di input devono avere la stessa grandezza.

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 max supporta completamente gli array di GPU. Per eseguire la funzione su una GPU, specificare i dati di input come un gpuArray (Parallel Computing Toolbox). 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:

• L'output dell'indice non è supportato per gli input tabulari distribuiti.

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

Cronologia versioni

Introduzione prima di R2006a

R2024b: Specifica del secondo array di input come array di caratteri non supportata

Specificare un secondo array di input come array di caratteri restituisce un errore. Questa modifica minimizza la confusione con altri argomenti che possono essere specificati come vettori di caratteri, come la condizione di valore mancante. Per mantenere la funzionalità precedente, è possibile convertire il secondo array di input in double, ad esempio max(A,double(B),"includenan").

R2023b: Specifica del secondo array di input come array di caratteri non più supportata in futuro

In una release futura, specificare un secondo array di input come array di caratteri genera un avviso e causerà un errore. Questa modifica minimizza la confusione con altri argomenti che possono essere specificati come vettori di caratteri, come la condizione di valore mancante. Per mantenere la funzionalità precedente, è possibile convertire il secondo array di input in double, ad esempio max(A,double(B),"includenan").

R2023a: Specifica della condizione di valore mancante

Omettere o includere tutti i valori mancanti negli array di input durante il calcolo del valore massimo utilizzando le opzioni "omitmissing" o "includemissing". In precedenza, "omitnan", "includenan", "omitnat", "includenat", "omitundefined" e "includeundefined" specificavano una condizione di valore mancante specifica per il tipo di dato degli array di input.

R2023a: Esecuzione di calcoli direttamente su tabelle e orari

La funzione max può eseguire calcoli su tutte le variabili all’interno di una tabella o di un orario senza dover eseguire indicizzazioni per accedere a tali variabili. Tutte le variabili devono avere tipi di dati che supportino il calcolo. Per maggiori informazioni, vedere Direct Calculations on Tables and Timetables.

R2021b: Specifica del metodo di confronto

Specificare il metodo del valore reale o assoluto per determinare il valore massimo dell'input utilizzando il parametro ComparisonMethod.

R2018b: Interventi su più dimensioni

Operare su più dimensioni degli array di input contemporaneamente. Specificare un vettore di dimensioni operative o specificare l'opzione "all" per intervenire su tutte le dimensioni dell’array.

Vedi anche

Funzioni

• maxk | bounds | min | mean | median | sort | islocalmax | clip

Argomenti

• Indicizzazione di array