Image Class Function Manual (V-Z)

VAR

| HOME | BACK |

Purpose

To determine the value of the variance of all elements in an Image.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{double} ret  =  object.VAR()

Example:

->A.matrix() = [1 2 3; 4 5 6; 7 8 9]

->B = A.var()

->print B

        7.50000

See also (class function)

max, min, mean, sd

| HOME | BACK |


VECRC2XY

| HOME | BACK |

Purpose

To convert from a vector of row and column numbers to a vector of x y coordinates.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{VecPt2D} ret  =  object.VECRC2XY({VecPt2D} argm1)

argm1 = list of row and column numbers

Example:

->vec_xy = Img.vecrc2xy(vec_rc)

->

See also (class function)

rc2xy, xy2rc, vecxy2rc, vidrc2xy, vidxy2rc

| HOME | BACK |


VECRCPLINE2XY

| HOME | BACK |

Purpose

To convert poly-lines represented by row and column numbers, VecRCpline objects,  to poly-lines represented by x y coordinates, VecXYpline objects.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{VecXYpline} ret  =  object.VECRCPLINE2XY({VecRCpline} argm1)

argm1 = list of poly-lines in row and column numbers

Example:

->vec_pline_xy = Img.vecrcpline2xy(vec_pline_rc)

->

See also (class function)

vecxypline2rc

| HOME | BACK |


VECXY2RC

| HOME | BACK |

Purpose

To convert from a vector of x y coordinates to a vector of row and column numbers.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{VecIndx} ret  =  object.VECXY2RC({VecPt2D} argm1)

argm1 = list of x y coordinates

Example:

->vec_rc = Img.vecxy2rc(vec_xy)

->

See also (class function)

rc2xy, xy2rc, vecrc2xy, vidrc2xy, vidxy2rc

| HOME | BACK |


VECXYPLINE2RC

| HOME | BACK |

Purpose

To convert poly-lines represented by x y coordinates, VecXYpline objects,  to poly-lines represented by row and column numbers, VecRCpline objects.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{VecRCpline} ret  =  object.VECXYPLINE2RC({VecXYpline} argm1)

argm1 = list of poly-lines in x y coordinates

Example:

->vec_pline_rc = Img.vecxypline2rc(vec_pline_xy)

->

See also (class function)

vecrcpline2xy

| HOME | BACK |


VIDRC2XY

| HOME | BACK |

Purpose

To convert from a vector of IdIndx objects, ID with row and column numbers, to a vector of IDPt2D, ID with x y coordinates.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{VecIdPt2D} ret  =  object.VIDRC2XY({VecIdPt2D} argm1)

argm1 = list of ID, row, and column numbers

Example:

->vid_xy = Img.vidrc2xy(vid_rc)

->

See also (class function)

rc2xy, xy2rc, vecxy2rc, vidrc2xy, vidxy2rc

| HOME | BACK |


VIDXY2RC

| HOME | BACK |

Purpose

To convert from a vector of IDPt2D, ID with x y coordinates, to a vector of IdIndx objects, ID with row and column numbers.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{VecIdIndx} ret  =  object.VIDXY2RC({VecIdPt2D} argm1)

argm1 = list of ID, x and y coordinates

Example:

->vid_rc = Img.vidxy2rc(vid_xy)

->

See also (class function)

rc2xy, xy2rc, vecxy2rc, vidrc2xy, vidxy2rc

| HOME | BACK |


VISIBLE

| HOME | BACK |

Purpose

To generate a visibility map from an image.  The calling image, from which a visibility map is generated, is thought of a Digital Elevation Model (DEM), and one point within the DEM must be given by the user.  The visibility map shows all pixels that can be visible from the given point.  If want to, a specific elevation height can be given to the function to add to or subtract from the elevation of the viewing point.

The result is an Image_uch object, where 0 represents non-visible pixels, and 255 represents visible pixel.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{Image_uch} ret  =  object.VIDXY2RC({double} argm1,{double} argm2,[{double} argm3])

argm1 = x coordinate of the view point

argm2 = y coordinate of the view point

argm3 = height to add to or subtract from elevation of the view point

        (default = 0)

Example:

->Img_vis_map = Img.visible(100,200,1.5)

->

See also (class function)

 

| HOME | BACK |


VLOAD

| HOME | BACK |

Purpose

To virtually load an Image object, saved as Noobeed format.  The document file is read but the data file.  The function simply opens the data file and get ready to perform some functions. 

Please note that only a limited set of functions is available for a virtually loaded matrix.  Function supported in a vload matrix are goget, goset, gosetmat, window, skip, stretch, stretchfix, min, max, mean, sd, var, and those function that do not requated data, such as nrow, ncol, rc2xy, xy2rc etc.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{void} object.VLOAD({String} argm1, [{String} argm2])

argm1 = file name for the documentation file (default extension is ".txt")

argm2 = file name for the data file  

        (default file name is same file name as argm1 with an extension ".raw")

Example:

->Img = Image()

->A.vload("my_image")

->

See also (class function)

load

| HOME | BACK |


WINDOW

| HOME | BACK |

Purpose

To cut a window out of an Image.  This function does not perform resample, therefore the result window image is the nearest possible to the required cutting window.  If an exact window of image is wanted, the user can prepare a desired blank image and use function "overlay" to get the result.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

For class Image

{Image} ret  =  object.WINDOW({double} argm1, {double} argm2, {double} argm3, {double} argm4)

For class Image_flt

{Image_flt} ret  =  object.WINDOW({double} argm1, {double} argm2, {double} argm3, {double} argm4)

For class Image_int

{Image_int} ret  =  object.WINDOW({double} argm1, {double} argm2, {double} argm3, {double} argm4)

For class Image_sht

{Image_sht} ret  =  object.WINDOW({double} argm1, {double} argm2, {double} argm3, {double} argm4)

For class Image_uch

{Image_uch} ret  =  object.WINDOW({double} argm1, {double} argm2, {double} argm3, {double} argm4)

For class Image_bln

{Image_bln} ret  =  object.WINDOW({double} argm1, {double} argm2, {double} argm3, {double} argm4)

argm1 = x coordinate of the lower left corner of the window

argm2 = y coordinate of the lower left corner of the window

argm3 = x coordinate of the upper right corner of the window

argm4 = y coordinate of the upper right corner of the window

Example:

->Img_win = Img.window(10.00, 10.00, 50.50, 50.50)

See also (class function)

overlay

| HOME | BACK |


X2COL

| HOME | BACK |

Purpose

To convert from an x coordinate to a column number.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{int} ret  =  object.X2COL({double} argm1)

argm1 = x coordinate

Example:

->c = Img.x2col(12.544, 22.986)

->

See also (class function)

y2row, rc2xy, xy2rc, vecrc2xy, vecxy2rc, vidrc2xy, vidxy2rc

| HOME | BACK |


XY2RC

| HOME | BACK |

Purpose

To convert from an x y coordinate to  row and column index number. 

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{Index} ret  =  object.XY2RC({double} argm1, {double} argm2)

argm1 = x coordinate

argm2 = y coordinate

Example:

->ind1 = Img.xy2rc(12.544, 22.986)

->

See also (class function)

rc2xy, vecrc2xy, vecxy2rc, vidrc2xy, vidxy2rc

| HOME | BACK |


Y2ROW

| HOME | BACK |

Purpose

To convert from a y coordinate to a row number.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{int} ret  =  object.Y2ROW({double} argm1)

argm1 = y coordinate

Example:

->r = Img.y2row(12.544, 22.986)

->

See also (class function)

col2x, rc2xy, xy2rc, vecrc2xy, vecxy2rc, vidrc2xy, vidxy2rc

| HOME | BACK |


ZONING

| HOME | BACK |

Purpose

To make a zoning image map.

The calling image must contain points that have a different value, called ID, for example 1, 2, 3.  The function creates a new image and assigns to its pixel the value of ID that is the closest to the pixel.

The result image is equivalent to the so-called Voronoi diagram.

Class

Image, Image_flt, Image_int, Image_sht, Image_uch, Image_bln

Usage

{Image_int} ret  =  object.ZONING()

Example:

->Zone_map = Img.zoning()

->

See also (class function)

dist

| HOME | BACK |