NAME

       plimagefr - Plot a 2D matrix using cmap1

SYNOPSIS

       plimagefr(idata,  nx,  ny,  xmin,  xmax, ymin, ymax, zmin, zmax, valuemin, valuemax, pltr,
       pltr_data)

DESCRIPTION

       Plot a 2D matrix using cmap1.

       Redacted form:  General: plimagefr(idata, xmin, xmax, ymin, ymax,  zmin,  zmax,  valuemin,
       valuemax, pltr, pltr_data)

       This function is used in example 20.

ARGUMENTS

       idata (const PLFLT * const *, input)
              A 2D array of values (intensities) to plot.  Should have dimensions idata[nx][ny].

       nx, ny (PLINT, input)
              Dimensions of idata

       xmin, xmax, ymin, ymax (PLFLT, input)
              Stretch  image  data  to these Plot coordinates.  idata[0][0] corresponds to (xmin,
              ymin) and idata[nx - 1][ny - 1] corresponds to (xmax, ymax).

       zmin, zmax (PLFLT, input)
              Only data between zmin and zmax (inclusive) will be plotted.

       valuemin, valuemax (PLFLT, input)
              The minimum and maximum data values to use for value to color  mappings.   A  datum
              equal  to or less than valuemin will be plotted with color 0.0, while a datum equal
              to or greater than valuemax will be plotted with color 1.0.  Data between  valuemin
              and valuemax map linearly to colors between 0.0 and 1.0.

       pltr (void (*) (PLFLT, PLFLT, PLFLT *, PLFLT *, PLPointer) , input)
              Pointer  to  function  that  defines a transformation between the data in the array
              idata and world coordinates.  An input coordinate of  (0,  0)  corresponds  to  the
              "top-left"  corner of idata while (nx, ny) corresponds to the "bottom-right" corner
              of idata.  Some transformation  functions  are  provided  in  the  PLplot  library:
              pltr0(3plplot)  for  identity  mapping,  and  pltr1(3plplot) and pltr2(3plplot) for
              arbitrary mappings respectively defined by one-  and  two-dimensional  arrays.   In
              addition,  user-supplied  routines  for  the  transformation  can  be used as well.
              Examples of all of these approaches are given in  the  PLplot  documentation.   The
              transformation  function  should  have  the  form  given  by any of pltr0(3plplot),
              pltr1(3plplot), or pltr2(3plplot).

       pltr_data (PLPointer, input)
              Extra  parameter  to  help  pass  information  to  pltr0(3plplot),  pltr1(3plplot),
              pltr2(3plplot), or whatever routine is externally supplied.

AUTHORS

       Many  developers  (who  are  credited  at  http://plplot.sourceforge.net/credits.php) have
       contributed to PLplot over its long history.

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/documentation.php.

                                          February, 2014                       PLIMAGEFR(3plplot)