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.