HTML automatically generated with rman
Table of Contents
ccdplot - display program for 2D image maps (contour and/or gray-scale)
ccdplot in=snapshot [parameter=value]
ccdplot is a quick
and dirty way to plot a contour representation of a 2D image map. It can
also superimpose a grayscale represention (not all yapp devices support
this though), or optionally leave out the contour values.
3D images cannot
be plotted, but data files that contain multiple 2D images are plotted
in succession.
The following parameters are recognized in order;
they may be given in any order if the keyword is also given. Use --help to
confirm this man page is up to date.
- in=in-file
- input file, must be in Image(5)
format. [no default]
- contour=values
- A list of contour values to be plotted.
If the keyword is not used a grayscale-map is produced between displaylevels
mmin and mmax (see below). For mmin < mmax this will be a ’negative’ image
(lowest values are white, which is also the default). For mmin > mmax this
will be a ’positive’ image. [default: no contour levels plotted, grayscale
is plotted]
- gray=true|false
- Should the grayscale map be used/superimposed?
[default depends on usage of contour keyword].
- mmin=mmin
- Minimum mapvalue
to be plotted. [default: auto-scaled].
- mmax=mmax
- Maximum mapvalue to be plotted
[default: auto-scaled].
- power=value
- Power of the transfer function for a
grayscale display, also known as the gamma factor. Only values between mmin
and mmax are plotted. A power greater than one will enhance the higher intensities,
smaller than 1 the lower intensities. Another possibility is to apply a
mathematical transformation using ccdmath(1NEMO)
before this program. [default:
1, i.e. a linear transfer function].
- xrange=values
- Range in x to plot, e.g.
-2:2 [default: whole matrix, sizes are obtained from mapheader]. Warning:
BUG, don’t used
- yrange=values
- Range in y to plot. See xrange. Warning: BUG,
don’t used
- headline=
- optional header above plot [Default: not used]
- tab=
- Output table of contour segments. Default not used.
- format=
- Format for above
table [Default: %g]
- cmode=
- Contour mode (0=orginal 1=pgplot) [Default:
0]
- blankval=
- if used, use this as blankval. Default not used.
- ltype=
- width
and type for contour. Default: 1,1
- xlab=
- (override) Label along X-axis
- ylab=
- (override) Label along Y-axis
- xscale=
- Scale all X values by this
- yscale=
-
Scale all Y values by this
ccdplot foo.dat contour=1:10:0.5 contour map only
ccdplot foo.dat gray scale map only, with default min/max
ccdplot foo.dat contour=1:10:2 gray=true contour + gray scale map overlayed
Future EnhancementsA color bar at the bottom, or so. Extensive encoding
of contour-levels etc. around plot-frame
Sorting contour values must be done
(sort of a bug really)
See Alsoimage(5NEMO), ccddisplay(1NEMO), uns_2dplot(1NEMO)
BugsNot always greyscale map produced, you may need an old version of my
yapp_ps. We haven’t decided on a proper way to call/define pl_matrix(3NEMO)
I guess. Clipping absent, produces awkward pictures when not whole area
to be displayed.
Plotting subregions doesn’t work
AuthorPeter Teuben Files
~/src/image/misc ccdplot.c
29-jun-87 V1.0: created from ccd’s module PJT
30-jun-87 V1.1: improved ’struct’ filestruc PJT
6-jul-87 V1.2: order keywords optimized for cnt/gray PJT
8-jul-87 V1.4: proper defn. of cell-position PJT
1-jun-88 V2.0: name change, new filestruct, though code same PJT
3-apr-91 V2.2: documented that big bug PJT
13-jan-92 V2.3: added greyscale as plotlabel PJT
29-mar-97 fixed outdated doc PJT
20-feb-02 2.8: added ltype; also documented new parameters PJT
16-mar-05 3.0: added timestep label + multiple timestep plot PJT
Table of Contents