plimagefr
( | idata, |
| nx, | |
| ny, | |
| xmin, | |
| xmax, | |
| ymin, | |
| ymax, | |
| zmin, | |
| zmax, | |
| valuemin, | |
| valuemax, | |
| pltr, | |
pltr_data); |
Plot a 2D matrix using cmap1.
idata
(PLFLT_MATRIX, input)
A matrix of values (intensities) to plot. Should have
dimensions of nx by ny.
nx, ny
(PLINT, input)
Dimensions of idata
xmin, xmax, ymin, ymax
(PLFLT, 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, 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 in the range (0.0-1.0).
pltr
(PLTRANSFORM_callback, input)
A callback function that defines the transformation
between the zero-based indices of the matrix
and world coordinates.
If idatapltr is not supplied (e.g., is set to NULL
in the C case), then the x indices of
are mapped to the range
idataxmin through xmax and
the y indices of are
mapped to the range idataymin through
ymax.
For the C case, transformation functions are provided
in the PLplot library: pltr0 for the identity mapping, and pltr1
and pltr2 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 Part III, “ Supported computer languages ” for the details concerning how
PLTRANSFORM_callback 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; and pltr2.
Furthermore, some of our more sophisticated bindings (see, e.g., Chapter 10, Fortran Language) 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, input)
Extra parameter to help
pass information to pltr0, pltr1, pltr2, or whatever routine
is externally supplied.
Redacted form:
General:
plimagefr(idata, xmin, xmax, ymin, ymax,
zmin, zmax, valuemin, valuemax, pltr, pltr_data)
This function is used in example 20.