---
name: "plimagefr"
section: "3plplot"
platform: "linux"
package: "plplot-doc"
version: "5.15.0+dfsg2-15"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/plimagefr"
---

# plimagefr(3plplot)

Plot a 2D matrix using cmap1

## 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* (**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.