max - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Mathematics : Group Theory : 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[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 or minimum, respectively, of one or more arguments.

• 

Most often the arguments are of type numeric, being 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 or rtable-based Array as an argument, the maximum or minimum element contained in the list or Array will be returned.

• 

In most cases, a call to max or min containing an undefined value will produce undefined as its result.

• 

A call to max where one of the arguments is positive infinity will produce positive infinity as a result. Likewise, a call min containing negative infinity will produce negative infinity as a result. 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](...).

• 

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 will be 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)

max[defined]32,1.49,undefined,2.5

2.5

(7)

min[defined]undefined,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)

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

convertmaxx22,x+3,piecewise

&lcub;x22x121221x&plus;3x12&plus;1221x2212&plus;1221<x

(13)

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

&lcub;x3&plus;8x1x&plus;8x0x3&plus;8x1x&plus;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

L:=11&comma;12&comma;13&comma;14

(16)

indmax&lsqb;index&rsqb;L

ind:=4

(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

M:=11122122

(19)

indmax&lsqb;index&rsqb;M

ind:=2&comma;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

M:=11122122

(22)

M144&comma;55&comma;66

M1:=44&comma;55&comma;66

(23)

M

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

(24)

An error is expected here:

indmax&lsqb;index&rsqb;M

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

(25)

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

ind:=2

(26)

Vind

77

(27)

Compatibility

• 

The max and min commands were updated in Maple 2015.

• 

The C parameter was introduced in Maple 2015.

• 

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

See Also

convert/piecewise

evalr

extrema

initialfunctions

maximize

minimize

undefined

 


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam