ROBERTS Function

Performs a Roberts edge enhancement of an image.

Keywords

Col

Computes the column gradient (horizontal line enhancement). (Default: Col = 1)

NOTE: For horizontal line enhancement only, you must disable the vertical line enhancement by setting the Row keyword to 0.

Edge

A scalar string indicating how edge effects are handled. (Default: 'zero') Valid strings are:

'zero'

Sets the border of the output image to zero. (Default)

'copy' Copies the border of the input image to the output image.

No_Clip

If set, the result data type is greater than the image data type so that overflow values in result are not clipped.

TIP: Use the No_Clip keyword to avoid overflow conditions.

Return

A scalar string specifying a mathematical function to apply. Valid strings are 'abs', 'phase', and 'value'. The Return keyword is used with the Row and Col keywords per the following table. (Default: 'abs')


	*Return* = `'abs'`	*Return* = `'phase'`	*Return* = `'value'`
Col = 1,Row = 0	ABS(col grad)	Invalid Condition	column gradient
Col = 0,Row = 1	ABS(row grad)	Invalid Condition	row gradient
Col = 1,Row = 1	ABS(row grad)+ABS(col grad)	ATAN(row grad ÷ col grad), data type is double	Invalid Condition
Col = 0,Row = 0	Invalid Condition	Invalid Condition	Invalid Condition

Row

Computes the row gradient (vertical line enhancement). (Default: Row = 1)

NOTE: For vertical line enhancement only, you must disable the horizontal line enhancement by setting the Col keyword to 0.

Same_Type

If set, the result is the same data type as image; otherwise, the result image data type is always integer.

Zero_Negatives If set, all negative values in result are set to zero.

Discussion

The ROBERTS function supports multi-layer band-interleaved images. When image is 3D, it is treated as an array of images array(m, n, p), where p is the number of m-by-n images. Each image in the input array is then operated on separately and an array of the result images is returned.

The ROBERTS function performs edge sharpening and isolation on image. It returns an approximation to the Roberts edge enhancement operator for images. This approximation is:

G_A(j,k) = |F_j,k-F_j+1,k+1| + |F_j,k+1 - F_j+1,k|

The resulting image returned by ROBERTS has the same dimensions as the input image.

CAUTION: Because the result image is saved in integer format, large original data values will cause overflow. Overflow occurs when the absolute value of the result is larger than 32,767. Use the No_Clip keyword to avoid overflow.

Example

This example uses the ROBERTS function to apply the Roberts edge enhancement operator to an aerial image. The final edge enhanced image is the absolute value of the difference between the original image and the image from the ROBERTS function.

OPENR, unit, FILEPATH('aerial_demo.img', Subdir='data'), /Get_Lun

; Open the file containing the image.

img = BYTARR(512, 512)

; Create an array large enough to hold the image.

READU, unit, img

; Read the image data.

FREE_LUN, unit

; Close the file and free the file unit number.

WINDOW, 0, Xsize = 1024, Ysize = 512

; Create a window large enough to hold two 512-by-512 images.

TV, img

; Display the original image in the left-half of the window.

HIST_EQUAL_CT, img
TV, ABS(img - ROBERTS(img)), 1

; Display the absolute value of the difference between the original
; image and the result of the ROBERTS function in the right-half of
; the window.

Figure 2-95 Original image (left), and Roberts edge enhanced image (right).

Figure 2-96 Original image (left), and Roberts edge enhanced image (right).

ROBERTS Function

Usage

Input Parameters

Returned Value

Keywords

Discussion

Example

See Also