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)