2.2.7.  imageData 
  Purpose  
Generate PNG image from data in given column (or 2D data of overall table).
 
  Usage  
> imageData options file[s] 
 
  Options  
 
-  -l/--label[ all ]
-     column containing data
-  -r/--range[ auto ]
-     data range (min max)
-  --gap=float/--transparent[ none ]
-     value to treat as transparent
-  -d/--dimension[ native ]
-     data dimension (width height)
-  --color[ gray ]
-     color scheme
-  --invert
-     invert color scheme
-  --abs
-     magnitude of values
-  --log
-     log10 of values
-  --fliplr
-     flip around vertical axis
-  --flipud
-     flip around horizontal axis
-  --crop
-     pixels cropped on left, right, top, bottom
-  -N/--pixelsize
-     pixel per data point
-  -x/--pixelsizex
-     pixel per data point along x
-  -y/--pixelsizey
-     pixel per data point along y
-  --show
-     show resulting image
  
 
  Example  
  Single data column  
Suppose we have an ASCIItable that contains a column of two-dimensional data as in » type « below.
The additional columns » x « and » y « are not required and not considered either, but correspond to the interpretation of the data sequence based on 
--dimension 3 2, i.e. 3 points along x for each of two rows along y.
|  |  |  | 
|  | Figure 1: Exemplary output of the » type « column as two-dimensional image. |  | 
 
1 head
x y type
1 1 1
2 1 1
3 1 2
1 2 1
2 2 3
3 2 0
With
> imageData --label type --pixelsize 10 --dimension 3 2
the output shown in Figure 
1 results.
  Two-dimensional data array  
For an ASCIItable that directly contains a two-dimensional representation of a data field, such as
|  |  |  | 
|  | Figure 2: Exemplary output of the 8 by 7 data array as (distorted) image. |  | 
 
0 head
-1    0 0 0 0 0 0 0
-0.33 0 0 2 0 2 0 0
0.33  0 0 0 0 0 0 0
1     0 0 0 2 0 0 0
1.67  0 1 0 0 0 1 0
2.33  0 0 2 2 2 0 0
3     0 0 0 0 0 0 0
the processing with 
> imageData --pixelsizex 10 --pixelsizey 15 --color bluered --invert --range -1 3
yields the output shown in Figure 
2.