This is not technically a class but instead a set of constants and functions which operate on Isis special pixels. There are several types of special pixels defined under the namespace Isis which include: Isis::NullPixel has no data available Isis::LisPixel was saturated on the instrument Isis::HisPixel was saturated on the instrument Isis::LrsPixel was saturated during a computation Isis::HrsPixel was saturated during a computation As indicated, saturated pixels are either generated by the instrument or generated by a computation. For example, on the instrument with a 8-bit Analog-to-Digital converter, a gain setting could cause the conversion of many pixels to exceed 255. Because their are only 8-bits the value 255 is likely a High Instrument Saturation (His) value. Likewise, 0 would be a Low Instrument Saturation (Lis) value. The Lrs and Hrs values indicate Low or High Representation Saturation respectively. When an application program operates on non-special pixels using standard arithmetic operators (and other functions) it is possible that the operation could generate an Lrs or Hrs. Application programmer should take care when processing pixels to ensure that special pixels are not used in computations. These tests can be performed with various functions provided in this include file.
2008-01-10 Jeannie Walldren - Added new unitTests and modified StringToPixel() to allow the user to enter any legal and unique shortened version of special pixels.
