minxy

minxy

The minxy function returns the minimum value and coordinates of the minimum value for a 1-dimensional array, CImage, or list of numbers. This function is similar to the CStat:Min method but does not require calling new_stats() beforehand to create a CStats object. The related min function returns only the minimum value.

Syntax

nMin, nX, nY = minxy( Data )

nMin, nX, nY = minxy( n1, n2, n3, ... )

Data is a 1-dimensional array, list of numbers, or a CImage object.

n1, n2, n3, ... are numbers or string values that can be converted to numbers.

nMin is the minimum value found in Data.

nX and nY are the coordinates of the minimum value, starting at 1.

Remarks

If Data is a 1-dimensional array or the CImage has 1 dimension, the value of nY is returned as 1.

The CImage class supports values ranging from byte to double plus other pixel types.

For a CMatrix, the returned nX and nY can be difficult to untangle because the CMatrix does not require a fixed number of columns in each row.

Examples

The following script returns the minimum value of a table containing 1 million random numbers.

t = random( 1000000 )	-- create a table of numbers
v, x, y = minxy( t )	-- find the minimum value
Printf("Min=%lg at %d,%d\n", v, x, y )	-- list the minimum value and coordinates

The next script returns the minimum value and its coordinates for pixels in a CImage.

V = AttachView( "CImageView" )	-- attach the topmost image window
Assert( V and V:Count() > 0 )	-- make sure an image window is on top
v, x, y = minxy( V:GetImage() )	-- use the current image in the CImageView
Printf("Min=%lg, %d,%d\n", v, x, y )	-- list the minimum value and coordinates

The next example computes the minimum value of a list of numbers:

v, x, y = minxy( 5, 6, -2, "8.4" }	-- find the minimum value
Printf("Min = %lg, %d,%d\n", v, x, y )	-- result: Min = 8.4, 4, 1

Syntax

Remarks

Examples

Related Topics