1 .TH xpm2ps 1 "Mon 4 Apr 2011" "" "GROMACS suite, VERSION 4.5.4-dev-20110404-bc5695c"
3 xpm2ps - converts XPM matrices to encapsulated postscript (or XPM)
5 .B VERSION 4.5.4-dev-20110404-bc5695c
9 .BI "\-f2" " root2.xpm "
11 .BI "\-do" " out.m2p "
12 .BI "\-o" " plot.eps "
13 .BI "\-xpm" " root.xpm "
15 .BI "\-[no]version" ""
19 .BI "\-title" " enum "
21 .BI "\-legend" " enum "
26 .BI "\-rainbow" " enum "
27 .BI "\-gradient" " vector "
29 .BI "\-[no]zeroline" ""
30 .BI "\-legoffset" " int "
31 .BI "\-combine" " enum "
35 \&\fB xpm2ps\fR makes a beautiful color plot of an XPixelMap file.
36 \&Labels and axis can be displayed, when they are supplied
37 \&in the correct matrix format.
38 \&Matrix data may be generated by programs such as \fB do_dssp\fR, \fB g_rms\fR or
42 \&Parameters are set in the \fB .m2p\fR file optionally supplied with
43 \&\fB \-di\fR. Reasonable defaults are provided. Settings for the \fI y\fR\-axis
44 \&default to those for the \fI x\fR\-axis. Font names have a defaulting hierarchy:
45 \&titlefont \- legendfont; titlefont \- (xfont \- yfont \- ytickfont)
46 \&\- xtickfont, e.g. setting titlefont sets all fonts, setting xfont
47 \&sets yfont, ytickfont and xtickfont.
50 \&When no \fB .m2p\fR file is supplied, many settings are taken from
51 \&command line options. The most important option is \fB \-size\fR,
52 \&which sets the size of the whole matrix in postscript units.
53 \&This option can be overridden with the \fB \-bx\fR and \fB \-by\fR
54 \&options (and the corresponding parameters in the \fB .m2p\fR file),
55 \&which set the size of a single matrix element.
58 \&With \fB \-f2\fR a second matrix file can be supplied. Both matrix
59 \&files will be read simultaneously and the upper left half of the
60 \&first one (\fB \-f\fR) is plotted together with the lower right
61 \&half of the second one (\fB \-f2\fR). The diagonal will contain
62 \&values from the matrix file selected with \fB \-diag\fR.
63 \&Plotting of the diagonal values can be suppressed altogether by
64 \&setting \fB \-diag\fR to \fB none\fR.
65 \&In this case, a new color map will be generated with
66 \&a red gradient for negative numbers and a blue for positive.
67 \&If the color coding and legend labels of both matrices are identical,
68 \&only one legend will be displayed, else two separate legends are
70 \&With \fB \-combine\fR, an alternative operation can be selected
71 \&to combine the matrices. The output range is automatically set
72 \&to the actual range of the combined matrix. This can be overridden
73 \&with \fB \-cmin\fR and \fB \-cmax\fR.
76 \&\fB \-title\fR can be set to \fB none\fR to suppress the title, or to
77 \&\fB ylabel\fR to show the title in the Y\-label position (alongside
78 \&the \fI y\fR\-axis).
81 \&With the \fB \-rainbow\fR option, dull grayscale matrices can be turned
82 \&into attractive color pictures.
85 \&Merged or rainbowed matrices can be written to an XPixelMap file with
86 \&the \fB \-xpm\fR option.
90 X PixMap compatible matrix file
92 .BI "\-f2" " root2.xpm"
94 X PixMap compatible matrix file
100 .BI "\-do" " out.m2p"
102 Input file for mat2ps
104 .BI "\-o" " plot.eps"
106 Encapsulated PostScript (tm) file
108 .BI "\-xpm" " root.xpm"
110 X PixMap compatible matrix file
114 Print help info and quit
116 .BI "\-[no]version" "no "
117 Print version info and quit
119 .BI "\-nice" " int" " 0"
123 View output \fB .xvg\fR, \fB .xpm\fR, \fB .eps\fR and \fB .pdb\fR files
125 .BI "\-[no]frame" "yes "
126 Display frame, ticks, labels, title and legend
128 .BI "\-title" " enum" " top"
129 Show title at: \fB top\fR, \fB once\fR, \fB ylabel\fR or \fB none\fR
131 .BI "\-[no]yonce" "no "
132 Show y\-label only once
134 .BI "\-legend" " enum" " both"
135 Show legend: \fB both\fR, \fB first\fR, \fB second\fR or \fB none\fR
137 .BI "\-diag" " enum" " first"
138 Diagonal: \fB first\fR, \fB second\fR or \fB none\fR
140 .BI "\-size" " real" " 400 "
141 Horizontal size of the matrix in ps units
143 .BI "\-bx" " real" " 0 "
144 Element x\-size, overrides \fB \-size\fR (also y\-size when \fB \-by\fR is not set)
146 .BI "\-by" " real" " 0 "
149 .BI "\-rainbow" " enum" " no"
150 Rainbow colors, convert white to: \fB no\fR, \fB blue\fR or \fB red\fR
152 .BI "\-gradient" " vector" " 0 0 0"
153 Re\-scale colormap to a smooth gradient from white {1,1,1} to {r,g,b}
155 .BI "\-skip" " int" " 1"
156 only write out every nr\-th row and column
158 .BI "\-[no]zeroline" "no "
159 insert line in \fB .xpm\fR matrix where axis label is zero
161 .BI "\-legoffset" " int" " 0"
162 Skip first N colors from \fB .xpm\fR file for the legend
164 .BI "\-combine" " enum" " halves"
165 Combine two matrices: \fB halves\fR, \fB add\fR, \fB sub\fR, \fB mult\fR or \fB div\fR
167 .BI "\-cmin" " real" " 0 "
168 Minimum for combination output
170 .BI "\-cmax" " real" " 0 "
171 Maximum for combination output
176 More information about \fBGROMACS\fR is available at <\fIhttp://www.gromacs.org/\fR>.