 |
xpm2psMain Table of Contents |
VERSION 3.1
Thu 28 Feb 2002
| VERSION 3.1 |
xpm2ps makes a beautiful color plot of an XPixelMap file. Labels and axis can be displayed, when they are supplied in the correct matrix format. Matrix data may be generated by programs such as do_dssp, g_rms or g_mdmat.
Parameters are set in the m2p file optionally supplied with -di. Reasonable defaults are provided. Settings for the y-axis default to those for the x-axis. Font names have a defaulting hierarchy: titlefont -> legendfont; titlefont -> (xfont -> yfont -> ytickfont) -> xtickfont, e.g. setting titlefont sets all fonts, setting xfont sets yfont, ytickfont and xtickfont.
With -f2 a 2nd matrix file can be supplied, both matrix files will be read simultaneously and the upper left half of the first one (-f) is plotted together with the lower right half of the second one (-f2). The diagonal will contain values from the matrix file selected with -diag. Plotting of the diagonal values can be suppressed altogether by setting -diag to none. With -combine an alternative operation can be selected to combine the matrices. In this case, a new color map will be generated with a red gradient for negative numbers and a blue for positive.
If the color coding and legend labels of both matrices are identical, only one legend will be displayed, else two separate legends are displayed.
-title can be set to none to suppress the title, or to ylabel to show the title in the Y-label position (alongside the Y-axis).
With the -rainbow option dull grey-scale matrices can be turned into attractive color pictures.
Merged or rainbowed matrices can be written to an XPixelMap file with the -xpm option.
| option | filename | type | description |
|---|---|---|---|
| -f | root.xpm | Input | X PixMap compatible matrix file |
| -f2 | root2.xpm | Input, Opt. | X PixMap compatible matrix file |
| -di | ps.m2p | Input, Opt., Lib. | Input file for mat2ps |
| -do | out.m2p | Output, Opt. | Input file for mat2ps |
| -o | plot.eps | Output, Opt. | Encapsulated PostScript (tm) file |
| -xpm | root.xpm | Output, Opt. | X PixMap compatible matrix file |
| option | type | default | description |
|---|---|---|---|
| -[no]h | bool | no | Print help info and quit |
| -[no]X | bool | no | Use dialog box GUI to edit command line options |
| -nice | int | 0 | Set the nicelevel |
| -[no]w | bool | no | View output xvg, xpm, eps and pdb files |
| -[no]frame | bool | yes | Display frame, ticks, labels, title and legend |
| -title | enum | top | Show title at: top, once, ylabel or none |
| -[no]yonce | bool | no | Show y-label only once |
| -legend | enum | both | Show legend: both, first, second or none |
| -diag | enum | first | Diagonal: first, second or none |
| -combine | enum | halves | Combine two matrices: halves, add, sub, mult or div |
| -bx | real | 0 | Box x-size (also y-size when -by is not set) |
| -by | real | 0 | Box y-size |
| -rainbow | enum | no | Rainbow colors, convert white to: no, blue or red |
| -gradient | vector | 0 0 0 | Re-scale colormap to a smooth gradient from white {1,1,1} to {r,g,b} |
| -skip | int | 1 | only write out every nr-th row and column |
| -[no]zeroline | bool | no | insert line in xpm matrix where axis label is zero |