REBIN Function

Returns a vector or array resized to the given dimensions.

enabled.

Usage

result = REBIN(array, dim1, ... , dimn)

Input Parameters

arrayThe array to be sampled. Cannot be of string data type. Must have the same number of dimensions as the number of dimension parameters that you supply.

dimi—The dimension(s) of the resampled array. Must be integral multiples or factors of the original array’s dimension(s).

Returned Value

result—The resized (resampled) vector or array.

Keywords

Sample—If present and nonzero, specifies that nearest neighbor sampling is to be used for both magnifying and shrinking operations.

If not present, specifies that bilinear interpolation is to be used for magnifying and that neighborhood averaging is to be used for shrinking. (Bilinear interpolation gives higher quality results, but requires more time.)

Note:

REBIN is multi-threaded for pure magnifications (including expansion into more dimensions) using nearest-neighbor sampling.

Discussion

The expansion or compression of each dimension is independent of the others; REBIN can expand or compress one dimension while leaving the others untouched.

Example

This example creates an image of a shaded surface, resizes the image using REBIN, then displays the resized image. The results are shown in Original and Resized Image.

; Create 20-by-20 single-precision, floating-point array where
; each element is proportional to its frequency. 
x = DIST(20)
; Display a shaded-surface representation of x.
SHADE_SURF, x, Color=0
LOADCT, 7
y = TVRD(0, 0, 640, 512)
; Get the content of the display subsystem's memory.
INFO, y
; PV-WAVE prints: VARIABLE     BYTE          = Array(640, 512)
; Resize the 640-by-512 array y and place the result in z.
z = REBIN(y, 320, 256)
; Create window of size 960-by-512.
WINDOW, 0, Xsize=960, Ysize=512
; Display larger image in position 0 of window.
TV, y, 0
; Display resized image in position 3 of window.
TV, z, 5

 

Original and Resized Image

See Also

CONGRID, EXPAND, INTRP, REFORM, REPLV, RESAMP

For more information on resampling and resizing images, see the PV‑WAVE User Guide.

For information on interpolation methods, see the PV‑WAVE User Guide.