min

Elementi minimi dell'array

Sintassi

M = min(A)

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

M = min(A,[],dim)

M = min(A,[],vecdim)

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

[M,I] = min(___)

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

C = min(A,B)

C = min(A,B,missingflag)

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

Descrizione

M = min(A) restituisce gli elementi minimi di un array.

• Se A è un vettore, min(A) restituisce il minimo di A.

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

• Se A è un array multidimensionale, min(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, min(A) restituisce una tabella di una riga contenente il minimo di ciascuna variabile. (da R2023a)

M = min(A,[],"all") restituisce il minimo di tutti gli elementi di A.

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

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

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

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

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

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

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

___ = min(___,"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 min(A,[],"ComparisonMethod","abs") confronta gli elementi di A in base ai loro valori assoluti e restituisce un valore minimo di -1.

Esempi

Elemento più piccolo del vettore

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

A = [23 42 37 15 52];
M = min(A)

M = 
15

Elemento più piccolo del vettore complesso

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

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

ans = 
-2.0000 + 2.0000i

Elemento più piccolo in ciascuna colonna della matrice

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

A = [2 8 4; 7 3 9]

A = 2×3

     2     8     4
     7     3     9

M = min(A)

M = 1×3

     2     3     4

Elemento più piccolo in ciascuna riga della matrice

Creare una matrice e calcolare l'elemento più piccolo 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 = min(A,[],2)

M = 2×1

    1.2000
    1.3000

Minimo della pagina dell'array

Creare un array tridimensionale e calcolare il minimo 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 = min(A,[],[1 2])

M1 = 
M1(:,:,1) =

    -2


M1(:,:,2) =

    -5


M1(:,:,3) =

    -3

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

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

M2 = 
-5

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

Mall = 
-5

Elemento più piccolo inclusi i valori mancanti

Creare una matrice contenente valori NaN.

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

A = 2×4

    1.7700   -0.0050    3.9800   -2.9500
       NaN    0.3400       NaN    0.1900

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

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

M = 1×4

       NaN   -0.0050       NaN   -2.9500

Indici degli elementi più piccoli

Creare una matrice A e calcolare gli elementi più piccoli 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] = min(A)

M = 1×3

     1     4    -5

I = 1×3

     1     2     2

Indici lineari di restituzione

Creare una matrice A e restituire il valore minimo 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] = min(A,[],2,"linear")

M = 2×1

     1
     4

I = 2×1

     1
     2

minvals = A(I)

minvals = 2×1

     1
     4

Confronto tra gli elementi più piccoli

Creare una matrice e restituire il valore più piccolo 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 = min(A,B)

C = 2×3

     1     5     3
     5     2     5

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, min(A) restituisce il numero complesso con la magnitudine più piccola. Se le magnitudini sono uguali, min(A) restituisce il valore con la magnitudine e l'angolo di fase più piccoli.

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

• Se A è un array vuoto 0x0, lo è anche min(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, min(A,dim) restituisce un array vuoto con la stessa grandezza di A.

Considerare una matrice di input m x n, A:

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

  

• min(A,[],2) calcola il minimo 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, min(A,[],[1 2]) restituisce un array 1x1x3 i cui elementi sono i minimi calcolati di ciascuna pagina di A.

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 minimo 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 minimo. Se un elemento qualsiasi della dimensione operativa è mancante, manca anche l'elemento corrispondente in M.
"includenan"	double, single, duration
"includenat"	datetime
"includeundefined"	categorical

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ì

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 minimi

scalare | vettore | matrice | array multidimensionale | tabella

Valori minimi, 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 minimi.

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

C — Elementi minimi da A o B

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

Elementi minimi 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 min 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.

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

• Per l'argomento di input A:

  • Se l'input è un array a grandezza variabile, la lunghezza della dimensione su cui operare deve essere diversa da zero in runtime.

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

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

• 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 min(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 min(real(A)) o min(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.

La funzione min 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 min supporta l'input di array GPU con queste note su utilizzo e limitazioni:

• Quando A è sparsa gpuArray, solo la sintassi min(A,[],"all") è supportata.

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

La funzione min supporta array distribuiti con le seguenti 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 min(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 min(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 minimo 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 min 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 minimo 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

• mink | bounds | max | mean | median | sort | islocalmin | clip

Argomenti

• Indicizzazione di array
• Compute Mean, Median, and Other Descriptive Statistics
• Compare Global, Moving, and Cumulative Statistics
• Explore Basic Statistics on 2-D Plot