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.
- idata (PLFLT_MATRIX(3plplot), input)
- A matrix of values (intensities) to plot. Should have dimensions of nx by ny.
- nx, ny (PLINT(3plplot), input)
- Dimensions of idata
- xmin, xmax, ymin, ymax (PLFLT(3plplot), input)
- See the discussion of pltr below for how these arguments are used (only for the special case when the callback function pltr is not supplied).
- zmin, zmax (PLFLT(3plplot), input)
- Only data between zmin and zmax (inclusive) will be plotted.
- valuemin, valuemax (PLFLT(3plplot), 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 in the range (0.0-1.0).
- pltr (PLTRANSFORM_callback(3plplot), input)
- A callback function that defines the transformation between the zero-based indices of the matrix idata and world coordinates. If pltr is not supplied (e.g., is set to NULL in the C case), then the x indices of idata are mapped to the range xmin through xmax and the y indices of idata are mapped to the range ymin through ymax.For the C case, transformation functions are provided in the PLplot library: pltr0(3plplot) for the identity mapping, and pltr1(3plplot) and pltr2(3plplot) for arbitrary mappings respectively defined by vectors and matrices. In addition, C callback routines for the transformation can be supplied by the user such as the mypltr function in examples/c/x09c.c which provides a general linear transformation between index coordinates and world coordinates.For languages other than C you should consult the PLplot documentation for the details concerning how PLTRANSFORM_callback(3plplot) arguments are interfaced. However, in general, a particular pattern of callback-associated arguments such as a tr vector with 6 elements; xg and yg vectors; or xg and yg matrices are respectively interfaced to a linear-transformation routine similar to the above mypltr function; pltr1(3plplot); and pltr2(3plplot). Furthermore, some of our more sophisticated bindings (see, e.g., the PLplot documentation) support native language callbacks for handling index to world-coordinate transformations. Examples of these various approaches are given in examples/<language>x09*, examples/<language>x16*, examples/<language>x20*, examples/<language>x21*, and examples/<language>x22*, for all our supported languages.
- pltr_data (PLPointer(3plplot), 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.org/credits.php) have contributed to PLplot over its long history.
SEE ALSO¶PLplot documentation at http://plplot.org/documentation.php.