CopyRegion copies (with an optional conversion of data types) all or part of a data set to a new data set. CopyRegion's user interface uses the same set of controls for selecting and processing a region as other Priism applications. The other controls are used when the new data set is written to a window. The RGB toggle selects whether the data is displayed in grayscale or color; the AutoScl and Restore buttons as well as the fields for the scaling on each wave select how the data is mapped to the pixel values displayed in the image.
When used to open a complete data set in an image window, CopyRegion is very similar to ViewFile. The difference is that CopyRegion makes a copy of the data in memory (and scratch space on the local file system) while ViewFile only loads the data as needed and does not have to keep a copy (though it may do so while space is available). The effect of these differences is that ViewFile returns control to the user more quickly, but once control is returned, the initial access to the data and images is faster when CopyRegion was used. Using CopyRegion instead of ViewFile also increases the amount of memory and disk space that Priism uses.
Overview | Region processing | RGB | AutoScl | Restore | Wave scales | Conversions
Priism | ViewFile | Scale values
When the output of CopyRegion is written to an image window, select this toggle to have the data displayed as color images; if the toggle is not selected the data is shown in levels of gray. The RGB toggle only affects how the data is displayed initially; controls on the image window can be used to switch between grayscales and color images after CopyRegion has written the data.
Overview | Region processing | RGB | AutoScl | Restore | Wave scales | Conversions
Select this toggle when you want each section, when copied to an image window, to be displayed in such a way that the range of data values in the section maps to the full range of image values. The default scaling parameters for each wave will still be those set from the wave scaling controls, but each section will have its own scaling parameters set and those defaults won't take effect.
Overview | Region processing | RGB | AutoScl | Restore | Wave scales | Conversions
Use this button to load the wave scaling values that had been used previously with the input data set and had been saved from the image window's Scale function.
Overview | Region processing | RGB | AutoScl | Restore | Wave scales | Conversions
When CopyRegion writes its output to a window and the AutoScl toggle is not on, these values set how the data is mapped to the quantities shown in the image. For details about how this mapping is done, see the documentation for the image window's Scale application.
If CopyRegion's input is a window, the default scale values are those for that window. When the input is a file, the default scale values are drawn from the minimum and maximum values recorded in the file's header. If you have looked at a file before and saved the scale parameters used (the documentation for Scale describes how to do this), you can use the Restore button to load those scale parameters.
Overview | Region processing | RGB | AutoScl | Restore | Wave scales | Conversions
By default, the data type of the output from CopyRegion is the same as the data type of the input. If the output data type (selected with the Mode control) is not the default, then a conversion is done. There are three cases where the conversion can be lossy:
For the conversion of a pure real format to a complex one, the imaginary part of the result is set to zero and the real part is set to the converted value.
Overview | Region processing | RGB | AutoScl | Restore | Wave scales | Conversions