HELP ARRAY_ROTATE                                   David Young
                                                    February 2000

LIB * ARRAY_ROTATE provides a procedure that circulates an array or
region of an array by moving values off the left edge and onto the right
edge, off the top and onto the bottom, etc.

array_rotate(_____arrin, ______region, _____shift, ______arrout) -> ______arrout
        _____arrin is an array. See *arraysample for the kinds of arrays that
        are handled most efficiently.

        ______region is a *boundslist type specification of the input region
        of the array. If <false>, then this defaults to the boundslist
        of _____arrin.

        _____shift is a list or vector specifying how far in each dimension
        to shift the input, as in *arrayshift.

        ______arrout may be an output array, which must contain the area
        specified by ______region, or it may be <false>, in which case an
        array with boundslist given by ______region is created and returned.
        ______arrout may be the same array as _____arrin, in which case the
        original data are overwritten by the rotated data.

        On exit, the part of ______arrout specified by ______region contains the
        circularly shifted values.

Note that array_rotate can be combined with *arrayshift to allow the
bounds of an array containing data that is periodic to be shifted
without, in effect, altering the position of the data.


--- ____________________________$popvision/help/array_rotate
--- _________Copyright __________University __of ______Sussex _____2000. ___All ______rights _________reserved.