|
Image Class Function Manual (V-Z) |
|
|
Image Class Function Manual (V-Z) |
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
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
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
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
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
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
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
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)
Purpose
To virtually load an Image object, saved as Noobeed format. The document file is read but not the data file. The function simply opens the data file and get ready to perform some functions. This function is particuilarily useful when the data file is large and the user doen not want to do load the data into memory.
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 functions that do not require contens in the data file, such as nrow, ncol, rc2xy, xy2rc etc.
When funish using the vload object, use the class function close() to close the data file.
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
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
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
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
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
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