1PLIMAGEFR(3plplot) PLplot API PLIMAGEFR(3plplot)
2
6 plimagefr - Plot a 2D matrix using color map1
7
9 plimagefr(idata, nx, ny, xmin, xmax, ymin, ymax, zmin, zmax, valuemin,
10 valuemax, pltr, pltr_data)
11
13 Plot a 2D matrix using color map1.
14 Redacted form: General: plimagefr(idata, xmin, xmax, ymin, ymax, zmin,
16 zmax, valuemin, valuemax, pltr, pltr_data)
17 This function is used in example 20.
20
22 idata (PLFLT**, input)
23 A 2D array of values (intensities) to plot. Should have dimen‐
24 sions idata[nx][ny].
25 nx, ny (PLINT, input)
27 Dimensions of idata
28 xmin, xmax, ymin, ymax (PLFLT, input)
30 Plot coordinates to strecth the image data to. idata[0][0] cor‐
31 responds to (xmin, ymin) and idata[nx - 1][ny - 1] corresponds
32 to (xmax, ymax).
33 zmin, zmax (PLFLT, input)
35 Only data between zmin and zmax (inclusive) will be plotted.
36 valuemin, valuemax (PLFLT, input)
38 The minimum and maximum data values to use for value to color
39 mappings. A datum equal to or less than valuemin will be plot‐
40 ted with color 0.0, while a datum equal to or greater than val‐
41 uemax will be plotted with color 1.0. Data between valuemin and
42 valuemax map linearly to colors between 0.0 and 1.0.
43 pltr (void (*) (PLFLT, PLFLT, PLFLT *, PLFLT *, PLPointer) , input)
45 Pointer to function that defines a transformation between the
46 data in the array idata and world coordinates. An input coordi‐
47 nate of (0, 0) corresponds to the "top-left" corner of idata
48 while (nx, ny) corresponds to the "bottom-right" corner of
49 idata. Some transformation functions are provided in the PLplot
50 library: pltr0(3plplot) for identity mapping, and pltr1(3plplot)
51 and pltr2(3plplot) for arbitrary mappings respectively defined
52 by one- and two-dimensional arrays. In addition, user-supplied
53 routines for the transformation can be used as well. Examples
54 of all of these approaches are given in the PLplot documenta‐
55 tion. The transformation function should have the form given by
56 any of pltr0(3plplot), pltr1(3plplot), or pltr2(3plplot).
57 pltr_data (PLPointer, input)
59 Extra parameter to help pass information to pltr0(3plplot),
60 pltr1(3plplot), pltr2(3plplot), or whatever routine is exter‐
61 nally supplied.
62
65 Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This
66 man page was automatically generated from the DocBook source of the
67 PLplot documentation, maintained by Alan W. Irwin and Rafael
68 Laboissiere.
69
71 PLplot documentation at http://plplot.sourceforge.net/resources.
72 July, 2010 PLIMAGEFR(3plplot)