bytscl: Convert to Color Array

Calling Sequence

...

  
bytscl(z[, top= max_byte][, cmin= lower_cutoff] 
       [, cmax= upper_cutoff])

Description

bytscl returns an unsigned char array of the same shape as z, with values linearly scaled to the range 0 to one less than the current palette size. If max_byte is specified, the scaled values will run from 0 to max_byte instead.

If lower_cutoff and/ or upper_cutoff are specified, z values outside this range are mapped to the cutoff value; otherwise the linear scaling maps the extreme values of z to 0 and max_byte.