NAME

       gmx-xpm2ps - Convert XPM (XPixelMap) matrices to postscript or XPM

SYNOPSIS

          gmx xpm2ps [-f [<.xpm>]] [-f2 [<.xpm>]] [-di [<.m2p>]] [-do [<.m2p>]]
                     [-o [<.eps>]] [-xpm [<.xpm>]] [-[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

       gmx  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 gmx rms or gmx 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.

OPTIONS

       Options to specify input files:

       -f [<.xpm>] (root.xpm)
              X PixMap compatible matrix file

       -f2 [<.xpm>] (root2.xpm) (Optional)
              X PixMap compatible matrix file

       -di [<.m2p>] (ps.m2p) (Optional, Library)
              Input file for mat2ps

       Options to specify output files:

       -do [<.m2p>] (out.m2p) (Optional)
              Input file for mat2ps

       -o [<.eps>] (plot.eps) (Optional)
              Encapsulated PostScript (tm) file

       -xpm [<.xpm>] (root.xpm) (Optional)
              X PixMap compatible matrix file

       Other options:

       -[no]w (no)
              View output .xvg, .xpm, .eps and .pdb files

       -[no]frame (yes)
              Display frame, ticks, labels, title and legend

       -title <enum> (top)
              Show title at: top, once, ylabel, none

       -[no]yonce (no)
              Show y-label only once

       -legend <enum> (both)
              Show legend: both, first, second, none

       -diag <enum> (first)
              Diagonal: first, second, 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, 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 (no)
              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, div

       -cmin <real> (0)
              Minimum for combination output

       -cmax <real> (0)
              Maximum for combination output

SEE ALSO

       gmx(1)

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

COPYRIGHT

       2024, GROMACS development team