zimg

Description

zimg generates png images from arbitrary formatted f(x,y) data. Both plain unformatted ascii and a variety of binary input formats are supported. Output options include variable logarithmic color mapping VLCM and contour graphics and lots of color maps. zimg is a fast converter.

News (07 Sep 2000): if zimg is linked against libgd >= 1.8 it can write additionally jpeg.

For further information you might want to have a look at the unix man page or the file README.

Examples

all following examples were created from this simple ascii input file.

the first image was created with the default color mapping: zimg stripe.dat > stripe01.gif

red color map using a red colormap can be achieved with the --red switch.

blue color map similarly a --blue selects a blue colormap.

the --time-stamp flag prints the date and the name of the input file on the output gif image.

xor any colormap can be exclusively ored with 0xff. Here the --xor switch was supplied additionally to the first example.

invert adding additionally the --invert switch displays the last example upside down.

As a more elaborated example serves the next example, which show the calculated reflectivity in a x-ray three-beam experiment. The six images were created from lasp.pi3.H and differ in the value for the logarithmic scale factor (--logarithmic switch) from 1 to 100000.

lasp01 lasp02 lasp03 lasp04 lasp05 lasp06

As one can see, VLCM faciliates the enhancement of low-amplitude data. Some of the possible colormappings are demonstrated next:

lasp08 lasp09 lasp10 lasp11 lasp12 lasp13

lasp14 lasp15 lasp16 lasp17 lasp18 lasp19

Big data sets can be cropped:

Invocation

All zimg options are selected with command-line switches. On startup a .zimgrc in the users home directory and in the current working directory are parsed for additional command line options. Furthermore options can be given as modeline within the data file itself. Options given on the command line will eventually overwrite the options from the .zimgrc's and modelines. For a full documentation of command line switches you should refer to the unix man page.

Where to get it

Go to the download directory to get the source distribution. Binary versions can be found in subdirectories for Linux / DEC osf / SGI IRIX 6.2 and HP-UX 9.??, 10.??. Contributors for binary releases are welcome. If you want to contribute, please contact me. See also the freshmeat application index.

This program is free software; you can redistribute it and/or modify it under the terms of a BSD type license.

Requirements

zimg uses Tom Boutell's png driver gd. If this driver isn't installed on your system (libgd.a is missing), you should first get the gd library. The configure / make / make install sequence should normally do the rest.

LAST MODIFICATION: "Fre, 24 Nov 2000 02:04:21 +0100 (joze)"

home | zellner | license | download