NAME

       xpm2ps - converts XPM matrices to encapsulated postscript (or XPM)

       VERSION 4.6.5

SYNOPSIS

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

DESCRIPTION

         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.

       When no  .m2p file is supplied, many settings are taken from command line  options.  The  most  important
       option  is   -size,  which  sets  the  size  of the whole matrix in postscript units.  This option can be
       overridden with the  -bx and  -by options (and the corresponding parameters in the  .m2p file), which set
       the size of a single matrix element.

       With  -f2 a second 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.  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.  With  -combine, an alternative operation can be selected to combine the matrices.
       The output range is automatically set to the actual range of the combined matrix. This can be  overridden
       with  -cmin and  -cmax.

         -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 grayscale matrices can be turned into attractive color pictures.

       Merged or rainbowed matrices can be written to an XPixelMap file with the  -xpm option.

FILES

       -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

OTHER OPTIONS

       -[no]hno
        Print help info and quit

       -[no]versionno
        Print version info and quit

       -nice int 0
        Set the nicelevel

       -[no]wno
        View output  .xvg,  .xpm,  .eps and  .pdb files

       -[no]frameyes
        Display frame, ticks, labels, title and legend

       -title enum top
        Show title at:  top,  once,  ylabel or  none

       -[no]yonceno
        Show y-label only once

       -legend enum both
        Show legend:  both,  first,  second or  none

       -diag enum first
        Diagonal:  first,  second or  none

       -size real 400
        Horizontal size of the matrix in ps units

       -bx real 0
        Element x-size, overrides  -size (also y-size when  -by is not set)

       -by real 0
        Element 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]zerolineno
        insert line in  .xpm matrix where axis label is zero

       -legoffset int 0
        Skip first N colors from  .xpm file for the legend

       -combine enum halves
        Combine two matrices:  halves,  add,  sub,  mult or  div

       -cmin real 0
        Minimum for combination output

       -cmax real 0
        Maximum for combination output

SEE ALSO

       gromacs(7)

       More information about GROMACS is available at <http://www.gromacs.org/>.

                                                 Mon 2 Dec 2013                                        xpm2ps(1)