g_xpm2ps(1)

1xpm2ps(1)                 GROMACS suite, VERSION 4.5                 xpm2ps(1)
2
3
4

NAME

6       xpm2ps - converts XPM matrices to encapsulated postscript (or XPM)
7
8       VERSION 4.5
9

SYNOPSIS

11       xpm2ps  -f  root.xpm  -f2  root2.xpm -di ps.m2p -do out.m2p -o plot.eps
12       -xpm root.xpm -[no]h -[no]version -nice int  -[no]w  -[no]frame  -title
13       enum  -[no]yonce  -legend  enum -diag enum -size real -bx real -by real
14       -rainbow enum -gradient vector -skip int -[no]zeroline  -legoffset  int
15       -combine enum -cmin real -cmax real
16

DESCRIPTION

18       xpm2ps  makes  a beautiful color plot of an XPixelMap file.  Labels and
19       axis can be displayed, when they are supplied  in  the  correct  matrix
20       format.   Matrix  data  may  be  generated by programs such as do_dssp,
21       g_rms or g_mdmat.
22
23
24       Parameters are set in the  m2p file optionally supplied with  -di. Rea‐
25       sonable defaults are provided. Settings for the y-axis default to those
26       for the x-axis. Font names have a  defaulting  hierarchy:  titlefont  -
27       legendfont;  titlefont  - (xfont - yfont - ytickfont) - xtickfont, e.g.
28       setting titlefont sets all fonts, setting xfont sets  yfont,  ytickfont
29       and xtickfont.
30
31
32       When  no   m2p  file  is supplied, many setting are set by command line
33       options. The most important option is  -size which sets the size of the
34       whole  matrix  in postscript units.  This option can be overridden with
35       the  -bx and  -by options (and the corresponding parameters in the  m2p
36       file), which set the size of a single matrix element.
37
38
39       With   -f2 a 2nd matrix file can be supplied, both matrix files will be
40       read simultaneously and the upper left half of the first one (  -f)  is
41       plotted  together  with  the lower right half of the second one ( -f2).
42       The diagonal will contain values from the  matrix  file  selected  with
43       -diag.  Plotting of the diagonal values can be suppressed altogether by
44       setting  -diag to  none.  In this case, a new color map will be  gener‐
45       ated  with a red gradient for negative numbers and a blue for positive.
46       If the color coding and legend labels of both matrices  are  identical,
47       only  one  legend will be displayed, else two separate legends are dis‐
48       played.  With  -combine an alternative operation  can  be  selected  to
49       combine  the  matrices.  The  output  range is automatically set to the
50       actual range of the combined matrix. This can be overridden with  -cmin
51       and  -cmax.
52
53
54         -title  can  be  set to  none to suppress the title, or to  ylabel to
55       show the title in the Y-label position (alongside the Y-axis).
56
57
58       With the  -rainbow option dull grey-scale matrices can be  turned  into
59       attractive color pictures.
60
61
62       Merged  or  rainbowed matrices can be written to an XPixelMap file with
63       the  -xpm option.
64

FILES

66       -f root.xpm Input
67        X PixMap compatible matrix file
68
69       -f2 root2.xpm Input, Opt.
70        X PixMap compatible matrix file
71
72       -di ps.m2p Input, Opt., Lib.
73        Input file for mat2ps
74
75       -do out.m2p Output, Opt.
76        Input file for mat2ps
77
78       -o plot.eps Output, Opt.
79        Encapsulated PostScript (tm) file
80
81       -xpm root.xpm Output, Opt.
82        X PixMap compatible matrix file
83
84

OTHER OPTIONS

86       -[no]hno
87        Print help info and quit
88
89       -[no]versionno
90        Print version info and quit
91
92       -nice int 0
93        Set the nicelevel
94
95       -[no]wno
96        View output xvg, xpm, eps and pdb files
97
98       -[no]frameyes
99        Display frame, ticks, labels, title and legend
100
101       -title enum top
102        Show title at:  top,  once,  ylabel or  none
103
104       -[no]yonceno
105        Show y-label only once
106
107       -legend enum both
108        Show legend:  both,  first,  second or  none
109
110       -diag enum first
111        Diagonal:  first,  second or  none
112
113       -size real 400
114        Horizontal size of the matrix in ps units
115
116       -bx real 0
117        Element x-size, overrides -size (also y-size when -by is not set)
118
119       -by real 0
120        Element y-size
121
122       -rainbow enum no
123        Rainbow colors, convert white to:  no,  blue or  red
124
125       -gradient vector 0 0 0
126        Re-scale colormap to a smooth gradient from white {1,1,1} to {r,g,b}
127
128       -skip int 1
129        only write out every nr-th row and column
130
131       -[no]zerolineno
132        insert line in xpm matrix where axis label is zero
133
134       -legoffset int 0
135        Skip first N colors from xpm file for the legend
136
137       -combine enum halves
138        Combine two matrices:  halves,  add,  sub,  mult or  div
139
140       -cmin real 0
141        Minimum for combination output
142
143       -cmax real 0
144        Maximum for combination output
145
146

NAME

SYNOPSIS

DESCRIPTION

FILES

OTHER OPTIONS

SEE ALSO