max - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Mathematics : Numbers : Integer Functions : max

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 floats.  However, the functionality is more general, allowing any type of argument for which an unevaluated function call may be returned.  When given a list, set, or rtable-based Array (a container) as an argument, the maximum or minimum element in the container is returned.

• 

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 returns positive infinity. Likewise, a call 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)

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

min

(11)

max

(12)

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

(13)

convertminx3&plus;8&comma;x&plus;8&comma;piecewise

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

(14)

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

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

7

(15)

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

(16)

indmaxindexL

ind4

(17)

Lind

14

(18)

Two-dimensional indexes 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

(19)

indmaxindexM

ind2,2

(20)

Mind

22

(21)

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

(22)

M144&comma;55&comma;66

M144&comma;55&comma;66

(23)

M

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

(24)

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;&infin;

V−477undefined

(25)

indmax&apos;index&apos;&comma;&apos;defined&apos;V

ind2

(26)

Vind

77

(27)

Compatibility

• 

The C parameter was introduced in Maple 2015.

• 

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

• 

The max and min commands were updated in Maple 2017.

• 

The nodefault option was introduced in Maple 2017.

• 

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

See Also

convert/piecewise

evalr

extrema

initialfunctions

maximize

minimize

undefined