max - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


max

find the maximum of numbers

min

find the minimum of numbers

 

Calling Sequence

Parameters

Description

Thread Safety

Examples

Compatibility

Calling Sequence

max(x1, x2, ...)

min(x1, x2, ...)

max[defined](x1, x2, ...)

min[defined](x1, x2, ...)

max[nodefault](x1, x2, ...)

min[nodefault](x1, x2, ...)

max[defined,nodefault](x1, x2, ...)

min[defined,nodefault](x1, x2, ...)

max[index](C)

min[index](C)

max[index,defined](C)

min[index,defined](C)

Parameters

x1, x2, ...

-

any expressions

C

-

list, set, Matrix, Array, or Vector

Description

• 

The functions max and min return the maximum and minimum, respectively, of one or more arguments.

• 

Most often the arguments are of type numeric: integers, rationals, or floating-point numbers.  However, the functionality is more general, as described in this section.

• 

When given a list, set, Array, Vector, or Matrix (a container) as an argument, the maximum or minimum element in the container is returned. Multiple container arguments will result in the maximum of the maximums or minimum of the minimums.

• 

Each value processed by max and min is recognized as falling into one of four categories: algebraic, numeric, Boolean, or string.

  

The values can be a mix of algebraic values and one of the numeric, Boolean, or string categories of values. If there are values of more than one of these three categories, an exception is raised.

• 

If the values consist solely of numeric, Boolean, or string values, the maximum or minimum value is returned.

• 

If any values are algebraic and a maximum or minimum cannot be determined, an unevaluated call to max or min is returned, with arguments consisting of the algebraic values, and one argument consisting of the maximum or minimum of the non-algebraic values if any were present.

• 

In most cases, a call to max or min containing an undefined value returns undefined.

• 

A call to max where one of the arguments is positive infinity and all the others are algebraic or numeric returns positive infinity. Likewise, a call to min containing negative infinity returns negative infinity. This is true even if one of the other arguments to max or min is undefined.

• 

To ignore undefined values when computing the maximum or minimum, use the optional index defined. That is, max[defined](...).

• 

By default, a call to max or min with no arguments or with only empty container arguments returns negative or positive infinity, respectively. If called with the index nodefault, the result is NULL instead.

• 

The functions max[index] and min[index] return the index of the maximum or minimum element in the container C.

  

Only one argument can be supplied when using the [index] variations.  The mandate for this option is that C[ max[index](C) ] give the maximal element.  That mandate cannot be fulfilled when C is a sequence, or when C is a container that has other containers inside (such as a list of vectors); an error is raised in these situations.

• 

These routines use evalr to try to resolve the relevant inequalities. Since evalr uses the current setting of Digits for its computations, it may help to increase Digits if either max(...) or min(...) returns unevaluated.

• 

The maximum and minimum of polynomials can be converted to a piecewise function.

Thread Safety

• 

The max and min commands are thread-safe as of Maple 15.

• 

For more information on thread safety, see index/threadsafe.

Examples

The following examples locate the maximum or minimum of numeric or constant values.

min1

1

(1)

max32,1.49

32

(2)

max35,ln2,913,

ln2

(3)

a24:

b3:

maxa,b

24

(4)

When an unknown is present, the max/min of the known values will be reduced, and the whole expression will be returned as an unevaluated function call, which can be symbolically manipulated or further evaluated later.

min32,1.49,fx

min1.49,fx

(5)

Use the defined option to determine the maximum or minimum ignoring all undefined values (returns the max/min of all defined values).

max32,1.49,undefined,2.5

undefined

(6)

maxdefined32,1.49,undefined,2.5

2.5

(7)

mindefinedundefined,8,3446

−3446

(8)

Note that infinity is known to be a maximum even in the presence of undefined.

max32,1.49,undefined,

(9)

Some algebraic combinations can be reduced.

maxx+1,x+2,y

maxy,x+2

(10)

max and min can work with Boolean values:

maxtrue,false

true

(11)

maxtrue,FAIL

FAIL

(12)

mintrue,FAIL

FAIL

(13)

The minimum and maximum of no arguments are, as expected, positive and negative infinity, respectively.

min

(14)

max

(15)

To return NULL instead, use the index nodefault.

maxnodefault

Unevaluated max/min expressions containing polynomials can be converted to piecewise functions.

convertmaxx22,x+3,piecewise

x22x12212x+3x12+212x2212+212<x

(16)

convertminx3+8&comma;x+8&comma;piecewise

x3+8x−1x+8x0x3+8x1x+81<x

(17)

max and min will search for values inside containers such as a list, set, Matrix, Vector, or Array.

max1&comma;2&comma;3&comma;4&comma;5&comma;6&comma;7

7

(18)

Use the index option to determine the location of the maximum or minimum value.  Only one argument can be used when asking for the index.

L11&comma;12&comma;13&comma;14

L11&comma;12&comma;13&comma;14

(19)

indmaxindexL

ind4

(20)

Lind

14

(21)

Two-dimensional indices are returned as a sequence and can be used to directly index the maximum or minimum value.  If multiple extreme values occur, only one index will be returned.

MMatrix11&comma;12&comma;21&comma;22

M11122122

(22)

indmaxindexM

ind2,2

(23)

Mind

22

(24)

max can find the maximum in a list of Arrays (or Array of lists, or general data container inside a data container). However, max[index] will raise an error because there is no simple index that can reference the element.

MMatrix11&comma;12&comma;21&comma;22

M11122122

(25)

M144&comma;55&comma;66

M144&comma;55&comma;66

(26)

M

44&comma;55&comma;6644&comma;55&comma;662122

(27)

An error is expected here:

indmaxindexM

Error, max value cannot be reached via a one-level index

The options index and defined can be used together to search for an extreme value in a container while ignoring undefined.

V4&comma;77&comma;undefined&comma;

V−477undefined

(28)

indmaxindex,definedV

ind2

(29)

Vind

77

(30)

Compatibility

• 

The C parameter was introduced in Maple 2015.

• 

For more information on Maple 2015 changes, see Updates in Maple 2015.

• 

The nodefault option was introduced in Maple 2017.

• 

For more information on Maple 2017 changes, see Updates in Maple 2017.

• 

The max and min commands were updated in Maple 2021.

See Also

convert/piecewise

evalr

extrema

initialfunctions

maximize

minimize

undefined