RAISE TO A POWER allows all the elements of the ROI of the current data to be raised to a desired power. Depending on the power entered this allows the elements to be squared (POWER = 2), the square root of the elements obtained (POWER = 0.5), the reciprocal of the elements calculated (POWER = -1), or an arbitrary power calculated. The operation is performed in place, the memory is not affected.
Depending on the power the range of valid input element values changes e.g. negative numbers are not valid if the square root is being taken. If invalid numbers are encountered the output will be given a special value and a warning message will be issued.
The user is prompted for the required power to which the ROI elements are to be raised. e.g. The prompt and input may be as follows to cube all the elements:
POWER [2]:3