plimagefr(3plplot) [debian man page]
PLIMAGEFR(3plplot) PLplot API PLIMAGEFR(3plplot) NAME
plimagefr - Plot a 2D matrix using color map1 SYNOPSIS
plimagefr(idata, nx, ny, xmin, xmax, ymin, ymax, zmin, zmax, valuemin, valuemax, pltr, pltr_data) DESCRIPTION
Plot a 2D matrix using color map1. 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 (PLFLT**, 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 trans- formation 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 trans- formation can be used as well. Examples of all of these approaches are given in the PLplot documentation. The transformation func- tion 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 sup- plied. AUTHORS
Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This man page was automatically generated from the DocBook source of the PLplot documentation, maintained by Alan W. Irwin and Rafael Laboissiere. SEE ALSO
PLplot documentation at http://plplot.sourceforge.net/resources. August, 2012 PLIMAGEFR(3plplot)
Check Out this Related Man Page
PLENV0(3plplot) PLplot API PLENV0(3plplot) NAME
plenv0 - Same as plenv(3plplot) but if in multiplot mode does not advance the subpage, instead clears it. SYNOPSIS
plenv0(xmin, xmax, ymin, ymax, just, axis) DESCRIPTION
Sets up plotter environment for simple graphs by calling pladv(3plplot) and setting up viewport and window to sensible default values. plenv0(3plplot) leaves enough room around most graphs for axis labels and a title. When these defaults are not suitable, use the individual routines plvpas(3plplot), plvpor(3plplot), or plvasp(3plplot) for setting up the viewport, plwind(3plplot) for defining the window, and plbox(3plplot) for drawing the box. Redacted form: plenv0(xmin, xmax, ymin, ymax, just, axis) This function is used in example 21. ARGUMENTS
xmin (PLFLT, input) Value of x at left-hand edge of window (in world coordinates). xmax (PLFLT, input) Value of x at right-hand edge of window (in world coordinates). ymin (PLFLT, input) Value of y at bottom edge of window (in world coordinates). ymax (PLFLT, input) Value of y at top edge of window (in world coordinates). just (PLINT, input) Controls how the axes will be scaled: -1: the scales will not be set, the user must set up the scale before calling plenv0(3plplot) using plsvpa(3plplot), plvasp(3plplot) or other. 0: the x and y axes are scaled independently to use as much of the screen as pos- sible. 1: the scales of the x and y axes are made equal. 2: the axis of the x and y axes are made equal, and the plot box will be square. axis (PLINT, input) Controls drawing of the box around the plot: -2: draw no box, no tick marks, no numeric tick labels, no axes. -1: draw box only. 0: draw box, ticks, and numeric tick labels. 1: also draw coordinate axes at x=0 and y=0. 2: also draw a grid at major tick posi- tions in both coordinates. 3: also draw a grid at minor tick positions in both coordinates. 10: same as 0 except logarithmic x tick marks. (The x data have to be converted to logarithms separately.) 11: same as 1 except logarithmic x tick marks. (The x data have to be converted to logarithms separately.) 12: same as 2 except logarithmic x tick marks. (The x data have to be converted to logarithms separately.) 13: same as 3 except logarithmic x tick marks. (The x data have to be converted to logarithms separately.) 20: same as 0 except logarithmic y tick marks. (The y data have to be converted to logarithms separately.) 21: same as 1 except logarithmic y tick marks. (The y data have to be converted to logarithms separately.) 22: same as 2 except logarithmic y tick marks. (The y data have to be converted to logarithms separately.) 23: same as 3 except logarithmic y tick marks. (The y data have to be converted to logarithms separately.) 30: same as 0 except logarithmic x and y tick marks. (The x and y data have to be con- verted to logarithms separately.) 31: same as 1 except logarithmic x and y tick marks. (The x and y data have to be converted to logarithms separately.) 32: same as 2 except logarithmic x and y tick marks. (The x and y data have to be converted to logarithms separately.) 33: same as 3 except logarithmic x and y tick marks. (The x and y data have to be converted to logarithms separately.) 40: same as 0 except date / time x labels. 41: same as 1 except date / time x labels. 42: same as 2 except date / time x labels. 43: same as 3 except date / time x labels. 50: same as 0 except date / time y labels. 51: same as 1 except date / time y labels. 52: same as 2 except date / time y labels. 53: same as 3 except date / time y labels. 60: same as 0 except date / time x and y labels. 61: same as 1 except date / time x and y labels. 62: same as 2 except date / time x and y labels. 63: same as 3 except date / time x and y labels. 70: same as 0 except custom x and y labels. 71: same as 1 except custom x and y labels. 72: same as 2 except custom x and y labels. 73: same as 3 except custom x and y labels. AUTHORS
Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This man page was automatically generated from the DocBook source of the PLplot documentation, maintained by Alan W. Irwin and Rafael Laboissiere. SEE ALSO
PLplot documentation at http://plplot.sourceforge.net/resources. August, 2012 PLENV0(3plplot)