max

Éléments maximaux d’un tableau

Syntaxe

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)

Description

M = max(A) renvoie les éléments maximaux d’un tableau.

• Si A est un vecteur, alors max(A) renvoie le maximum de A.

• Si A est une matrice, alors max(A) est un vecteur ligne contenant la valeur maximale de chaque colonne de A.

• Si A est un tableau multidimensionnel, alors max(A) opère le long de la première dimension de A dont la taille n’est pas égale à 1 en traitant les éléments comme des vecteurs. La taille de M dans cette dimension devient 1, tandis que les tailles de toutes les autres dimensions restent identiques à celles de A. Si A est un tableau vide dont la première dimension est de longueur nulle, alors M est un tableau vide de même taille que A.

• Si A est une table ou une timetable, alors max(A) renvoie une table à une seule ligne contenant le maximum de chaque variable. (depuis R2023a)

M = max(A,[],"all") détermine le maximum de tous les éléments de A.

M = max(A,[],dim) renvoie l’élément maximal le long de la dimension dim. Par exemple, si A est une matrice, alors max(A,[],2) renvoie un vecteur colonne contenant la valeur maximale de chaque ligne.

M = max(A,[],vecdim) renvoie le maximum des dimensions spécifiées dans le vecteur vecdim. Par exemple, si A est une matrice, alors max(A,[],[1 2]) renvoie le maximum de tous les éléments de A, car chaque élément d’une matrice est contenu dans la section de tableau définie par les dimensions 1 et 2.

M = max(A,[],___,missingflag) spécifie s’il faut omettre ou inclure les valeurs manquantes de A dans les syntaxes précédentes. Par exemple, max(A,[],"includemissing") inclut toutes les valeurs manquantes lors du calcul du maximum. Par défaut, max omet les valeurs manquantes.

[M,I] = max(___) renvoie également l’index correspondant à la première occurrence de la valeur maximale de A dans la dimension sur laquelle l’opération est réalisée.

[M,I] = max(A,[],___,"linear") renvoie également l’index linéaire de A correspondant à la valeur maximale de A.

C = max(A,B) renvoie un tableau contenant les plus grands éléments extraits de A ou de B.

C = max(A,B,missingflag) spécifie également comment traiter les valeurs manquantes.

___ = max(___,"ComparisonMethod",method) spécifie en option comment comparer les éléments dans les syntaxes précédentes. Par exemple, pour le vecteur A = [-1 2 -9], la syntaxe max(A,[],"ComparisonMethod","abs") compare les éléments de A selon leur valeur absolue et renvoie une valeur maximale égale à -9.

Exemples

Plus grand élément d’un vecteur

Créez un vecteur et calculez son plus grand élément.

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

M = 
52

Plus grand élément complexe

Créez un vecteur complexe et calculez son plus grand élément, c’est-à-dire celui ayant la plus grande amplitude.

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

ans = 
4.0000 + 1.0000i

Plus grand élément de chaque colonne d’une matrice

Créez une matrice et calculez le plus grand élément de chaque colonne.

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

Plus grand élément de chaque ligne d’une matrice

Créez une matrice et calculez le plus grand élément de chaque ligne.

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

Maximum d’une page du tableau

Créez un tableau 3D et calculez le maximum sur chaque page de données (lignes et colonnes).

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

Pour calculer le maximum sur toutes les dimensions d’un tableau, vous pouvez soit spécifier chaque dimension dans l’argument de dimension de vecteur, soit utiliser l’option "all".

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

M2 = 
13

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

Mall = 
13

Plus grand élément en incluant les valeurs manquantes

Créez une matrice contenant les valeurs 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

Calculez la valeur maximale de la matrice en incluant les valeurs manquantes. Pour les colonnes de la matrice qui contiennent une valeur NaN, le maximum est NaN.

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

M = 1×4

       NaN    0.3400       NaN    0.1900

Indices des plus grands éléments

Créez une matrice A et calculez les plus grands éléments de chaque colonne ainsi que les indices des lignes de A où ils sont présents.

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

Renvoyer des indices linéaires

Créez une matrice A et renvoyez la valeur maximale de chaque ligne dans la matrice M. Utilisez l’option "linear" pour renvoyer également les indices linéaires I tels que 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

Comparaison des plus grands éléments

Créez une matrice et renvoyez la plus grande valeur entre chacun de ses éléments comparé à un scalaire.

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

Arguments d'entrée

A — Tableau en entrée

scalaire | vecteur | matrice | tableau multidimensionnel | table | timetable

Tableau en entrée, spécifié sous forme de scalaire, de vecteur, de matrice, de tableau multidimensionnel, de table ou de timetable.

• Si A est complexe, max(A) renvoie le nombre complexe ayant la plus grande amplitude. Si les amplitudes sont égales, max(A) renvoie la valeur ayant la plus grande amplitude et le plus grand angle de phase.

• Si A est un scalaire, max(A) renvoie A.

• Si A est un tableau vide de 0 x 0, alors max(A) l’est également.

Si A est de type categorical, il doit être ordinal.

Types de données : double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration | table | timetable
Support des nombres complexes : Oui

dim — Dimension sur laquelle opérer

scalaire entier positif

Dimension sur laquelle opérer, spécifiée en tant que scalaire entier positif. Si vous ne spécifiez pas la dimension, la valeur par défaut est la première dimension de tableau dont la taille n’est pas égale à 1.

La dimension dim indique la dimension dont la longueur est réduite à 1. size(M,dim) est égal à 1, tandis que la taille de toutes les autres dimensions reste inchangée, sauf si size(A,dim) est égal à 0. Si size(A,dim) est égal à 0, alors max(A,dim) renvoie un tableau vide de même taille que A.

Prenez une matrice A en entrée de dimension m x n :

• max(A,[],1) calcule le maximum des éléments de chaque colonne de A et renvoie un vecteur ligne de dimension 1 x n.

  

• max(A,[],2) calcule le maximum des éléments de chaque ligne de A et renvoie un vecteur colonne de dimension m x 1.

  

vecdim — Vecteur de dimensions

vecteur de nombres entiers positifs

Vecteur de dimensions, spécifié sous forme de vecteur de nombres entiers positifs. Chaque élément représente une dimension du tableau en entrée. Les longueurs de la sortie dans les dimensions de fonctionnement spécifiées sont de 1, tandis que les autres restent inchangées.

Prenez A, un tableau d’entrée de 2 x 3 x 3. max(A,[],[1 2]) renvoie alors un tableau de 1 x 1 x 3 dont les éléments correspondent aux maximums calculés sur chaque page de A.

B — Tableau supplémentaire en entrée

scalaire | vecteur | matrice | tableau multidimensionnel | table | timetable

Tableau supplémentaire en entrée, spécifié sous forme de scalaire, de vecteur, de matrice, de tableau multidimensionnel, de table ou de timetable. Les entrées A et B doivent être de tailles identiques ou compatibles (par exemple, A est une matrice de dimension M x N et B est un scalaire ou un vecteur ligne de dimension 1 x N). Pour plus d’informations, consultez Tailles de tableau compatibles pour les opérations de base.

• Si A et B sont tous les deux des tableaux, ils doivent contenir le même type de données, sauf si l’un des deux est double. Dans ce cas, le type de données de l’autre tableau peut être single, duration ou tout type entier.

• Si A et B sont des tableaux categorical ordinaux, ils doivent contenir les mêmes ensembles de catégories dans le même ordre.

• Si A ou B est une table ou une timetable, l’autre entrée peut être un tableau, une table ou une timetable.

Si B est de type categorical, il doit être ordinal.

Types de données : double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration | table | timetable
Support des nombres complexes : Oui

missingflag — Condition de valeur manquante

"omitmissing" (par défaut) | "omitnan" | "omitnat" | "omitundefined" | "includemissing" | "includenan" | "includenat" | "includeundefined"

Condition de valeur manquante, spécifiée sous forme de l’une des valeurs de cette table.

Valeur	Type de données en entrée	Description
"omitmissing"	Tous les types de données supportés	Ignore les valeurs manquantes dans les tableaux en entrée et calcule le maximum sur un nombre réduit de points. Si tous les éléments de la dimension opérationnelle sont manquants, l’élément correspondant dans M l’est également.
"omitnan"	double, single, duration
"omitnat"	datetime
"omitundefined"	categorical
"includemissing"	Tous les types de données supportés	Inclue les valeurs manquantes dans les tableaux en entrée lors du calcul du maximum. Si un élément de la dimension opérationnelle est manquant, l’élément correspondant dans M l’est également.
"includenan"	double, single, duration
"includenat"	datetime
"includeundefined"	categorical

method — Méthode de comparaison

"auto" (par défaut) | "real" | "abs"

Méthode de comparaison des entrées numériques, spécifiée sous forme d’une des valeurs suivantes :

• "auto" : pour un tableau numérique en entrée A, comparez les éléments selon real(A) lorsque A est réel et selon abs(A) lorsque A est complexe.

• "real" : pour un tableau numérique en entrée A, comparez les éléments selon real(A) lorsque A est réel ou complexe. Si A contient des éléments dont les parties réelles sont égales, utilisez imag(A) pour les départager.

• "abs" : pour un tableau numérique en entrée A, comparez les éléments selon abs(A) lorsque A est réel ou complexe. Si A contient des éléments d’amplitude égale, utilisez angle(A) dans l’intervalle (-π,π] pour les départager.

Arguments de sortie

M — Valeurs maximales

scalaire | vecteur | matrice | tableau multidimensionnel | table

Valeurs maximales, renvoyées sous forme de scalaire, de vecteur, de matrice, de tableau multidimensionnel ou de table. size(M,dim) est égal à 1, tandis que la taille de toutes les autres dimensions est celle de la dimension correspondante dans A, sauf si size(A,dim) est égal à 0. Si size(A,dim) est égal à 0, alors M est un tableau vide de même taille que A.

I — Index

scalaire | vecteur | matrice | tableau multidimensionnel | table

Index, renvoyé sous forme de scalaire, de vecteur, de matrice, de tableau multidimensionnel ou de table. I est de la même taille que la première sortie.

Lorsque "linear" n’est pas spécifié, I est l’index dans la dimension sur laquelle l’opération est réalisée. Lorsque "linear" est spécifié, I contient les index linéaires de A correspondant aux valeurs maximales.

Si le plus grand élément est présent plusieurs fois, I contient l’index de la première occurrence de cette valeur.

C — Éléments maximaux de A ou de B

scalaire | vecteur | matrice | tableau multidimensionnel | table | timetable

Éléments maximaux de A ou de B, renvoyés sous forme de scalaire, de vecteur, de matrice, de tableau multidimensionnel, de table ou de timetable. La taille de C est déterminée par l’expansion implicite des dimensions de A et de B. Pour plus d’informations, consultez Tailles de tableau compatibles pour les opérations de base.

Le type de données de C dépend des types de données de A et de B :

• Si A et B contiennent le même type de données, alors C correspond au type de données de A et B.

• Si A ou B est single, alors C est single.

• Si A ou B est un type entier et que l’autre est de type scalaire double, alors C est du même type entier.

• Si A ou B est une table ou une timetable, alors C est une table ou une timetable.

Capacités étendues

Tall arrays

Calculer avec des arrays possédant plus de rangées que la mémoire ne peut en contenir.

La fonction max supporte les tall arrays avec les notes d’usage et limitations suivantes :

• L’index en sortie n’est pas supporté pour les entrées tabulaires tall.

Pour plus d’informations, consultez Tall array.

Génération de code C/C++

Générez du code C et C++ avec MATLAB® Coder™.

Notes d’usage et limitations :

• Pour utiliser un tableau vide comme second argument au run-time, vous devez spécifier un tableau de taille fixe 0 x 0 au moment de la génération de code.

• S’ils sont utilisés, les arguments dim, vecdim, missingflag et method doivent être des constantes au moment de la génération de code.

• Pour l’argument en entrée A :

  • Si vous ne spécifiez pas de dimension, le générateur de code opère le long de la première dimension du tableau en entrée dont la taille est variable ou n’est pas égale à 1. Si cette dimension est de taille variable au moment de la génération de code et égale à 1 au run-time, une erreur run-time peut survenir. Pour éviter cette erreur, spécifiez la dimension.

  • Dans le code généré, le tableau en entrée reste complexe même si tous ses éléments ont des parties imaginaires nulles. Dans une telle situation, les résultats produits par le code généré peuvent être différents de ceux produits par MATLAB. Consultez Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder).

Génération de code GPU

Générez du code CUDA® pour les GPU NVIDIA® avec GPU Coder™.

Notes d’usage et limitations :

• Pour utiliser un tableau vide comme second argument au run-time, vous devez spécifier un tableau de taille fixe 0 x 0 au moment de la génération de code.

• S’ils sont utilisés, les arguments dim, vecdim, missingflag et method doivent être des constantes au moment de la génération de code.

• Si vous ne spécifiez pas l’argument dim, le générateur de code opère le long de la première dimension de A dont la taille est variable ou n’est pas égale à 1.

• Si A est complexe et que tous les éléments de A ont des parties imaginaires nulles, il se peut que MATLAB^® convertisse A en real(A) avant d’appeler max(A). Dans ce cas, MATLAB compare les éléments selon real(A), mais le code généré les compare selon abs(A). Pour que le code généré se comporte comme MATLAB, utilisez max(real(A)) ou max(A,'ComparisonMethod','real'). Consultez Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder).

Génération de code HDL

Générez du code VHDL, Verilog et SystemVerilog pour les designs FPGA et ASIC avec HLD Coder™.

Notes d’usage et limitations :

• Les entrées qui sont des matrices 3D ou de dimension supérieure ne sont pas supportées.

• Les entrées qui ont des types de données complexes ne sont pas supportées.

• Les matrices ou vecteurs en entrée doivent être de taille égale.

Environnement basé sur les threads

Exécutez du code en arrière-plan avec MATLAB® backgroundPool ou accélérez le code avec Parallel Computing Toolbox™ ThreadPool.

La fonction max supporte entièrement les environnements basés sur des threads. Pour plus d’informations, consultez Run MATLAB Functions in Thread-Based Environment.

GPU Arrays

Accélérez le code en exécutant les calculs sur une unité de traitement graphique (GPU) avec Parallel Computing Toolbox™.

La fonction max supporte les GPU arrays avec les notes d’usage et limitations suivantes :

• Lorsque A est un gpuArray creux, seule la syntaxe max(A,[],"all") est supportée.

Pour plus d’informations, consultez Exécuter les fonctions MATLAB sur un GPU (Parallel Computing Toolbox).

Distributed arrays

Divisez les tableaux volumineux dans la mémoire combinée de votre cluster avec Parallel Computing Toolbox™.

La fonction max supporte les distributed arrays avec les notes d’usage et limitations suivantes :

• L’index en sortie n’est pas supporté pour les entrées tabulaires distribuées.

Pour plus d’informations, consultez Exécuter les fonctions MATLAB avec des tableaux distribués (Parallel Computing Toolbox).

Historique des versions

Introduit avant R2006a

R2024b: La spécification d’un tableau de caractères comme second tableau en entrée n’est pas supportée

La spécification d’un tableau de caractères comme second tableau en entrée renvoie une erreur. Cette modification réduit le risque de confusion avec d’autres arguments pour lesquels des vecteurs de caractères peuvent être spécifiés, par exemple la condition de valeur manquante. Pour conserver le fonctionnement précédent, vous pouvez convertir le second tableau en entrée vers le type double, par exemple max(A,double(B),"includenan").

R2023b: La spécification d’un tableau de caractères comme second tableau en entrée ne sera pas supportée

La spécification d’un tableau de caractères comme second tableau en entrée renvoie un avertissement et générera une erreur dans une prochaine version. Cette modification réduit le risque de confusion avec d’autres arguments pour lesquels des vecteurs de caractères peuvent être spécifiés, par exemple la condition de valeur manquante. Pour conserver le fonctionnement précédent, vous pouvez convertir le second tableau en entrée vers le type double, par exemple max(A,double(B),"includenan").

R2023a: Spécifier la condition de valeur manquante

Omettez ou incluez toutes les valeurs manquantes dans les tableaux en entrée lors du calcul de la valeur maximale en utilisant les options "omitmissing" ou "includemissing". Auparavant, "omitnan", "includenan", "omitnat", "includenat", "omitundefined" et "includeundefined" spécifiaient une condition de valeur manquante propre au type de données des tableaux en entrée.

R2023a: Effectuer des calculs directement dans les tableaux et les timetables

La fonction max peut procéder au calcul sur toutes les variables au sein d’un tableau ou d’une timetable sans indexation pour accéder à ces variables. Toutes les variables doivent avoir des types de données qui supportent les calculs. Pour plus d’informations, consultez Direct Calculations on Tables and Timetables.

R2021b: Spécifier la méthode de comparaison

Spécifiez la méthode de la valeur réelle ou absolue pour déterminer la valeur maximale de l’entrée avec le paramètre ComparisonMethod.

R2018b: Réaliser des opérations sur plusieurs dimensions

Réalisez des opérations sur plusieurs dimensions des tableaux en entrée à la fois. Spécifiez un vecteur de dimensions opérationnelles, ou spécifiez l’option "all" pour opérer sur toutes les dimensions d'un tableau.

Voir aussi

Fonctions

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

Rubriques

• Indexation des matrices
• Compute Mean, Median, and Other Descriptive Statistics
• Compare Global, Moving, and Cumulative Statistics
• Explore Basic Statistics on 2-D Plot