Cshift

Function Type:

Cshift is an array intrinsic procedure.

Function Purpose:

The function Cshift takes an array and preforms a circular shift of its elements along a specified dimension.

Required Arguments:

cshift( array,shift )

Array

Array can be an array of any size and rank.

Shift

Shift can be an integer or integer array with rank one less than the rank of "array". It dictates how many spaces to shift each element. A positive value would cause the end elements to be shifted toward the first position in the array. A negative value for shift would result in the beginning elements being shifted toward the high numbered end of the array. See the example below for use of "shift" as an array in conjunction with the optional argument "dim". If "array" has a rank greater than one and "shift" is a scalar (single integer) then that shift is applied everywhere.

Optional Arguments:

cshift( array,shift,dim )

Dim

Dim designates along which dimension of the array that the elements are shifted. This is optional because if this argument is omitted the compiler will assume dim=1.

				1 2 3 4
				5 6 7 8
				9 0 1 2  
 				3 4 5 6

		Granite2 = cshift( granite,shift=/1,-1,0,2/,dim=1 )

				5 4 3 2
				9 2 7 6
				3 6 1 4
				1 0 5 8

		granite2 = cshift( granite,shift=/1,-1,0,5/,dim=2/ )

				2 3 4 1
				8 5 6 7
				9 0 1 2
				5 6 3 4